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About This Document 
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Who Should Use This Document 


Who Should Use This Document 


This Guide is for programmers who are familiar working with programming languages. 


How This Document Is Organized 


45541L-003 Rev. A 


The Guide is set up as follows: 


Section 


Introduction 


Description 


Provides a high-level overview about this guide 
and Zebra Programming Language (ZPL). 


ZPL Commands 


Provides an alphabetical, detailed description of 
each ZPL command. 


RFID Commands 


Provides an alphabetical, detailed description of 
each ZPL RFID command, and some examples of 
how to use them. 


Wireless Print Server Commands 


Provides new and modified ZPL commands for the 
wireless print server. 


Appendixes 


The appendixes include: 
Zebra Code Pages 
ASCII 
Fonts and Bar Codes 
Mod 10 and Mod 43 Check Digits 
ZB64 Encoding and Compression 
Field Interactions 
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Contacts 


You can contact Zebra Technologies at the following: 


Web Site 


http://www.zebra.com 


About This Document 
Contacts 


Technical Support via the Internet is available 24 hours per day, 365 days per year. Go to 


http://www.zebra.com/support. 


The Americas 


Regional Headquarters 


Zebra Technologies International, 
LLC 

333 Corporate Woods Parkway 
Vernon Hills, Illinois 60061.3109 
U.S.A 

T: +1 847 793 2600 

Toll-free +1 800 423 0422 

F: +1 847 913 8766 


Regional Headquarters 


Zebra Technologies Europe Limited 
Zebra House 

The Valley Centre, Gordon Road 
High Wycombe 

Buckinghamshire HP13 6EQ, UK 
T: +44 (0)1494 472872 

F: +44 (0) 1494 450103 


Asia Pacific 


Regional Headquarters 


Zebra Technologies Asia Pacific, LLC 
16 New Industrial Road 

#05-03 Hudson TechnoCentre 
Singapore 536204 

T: +65 6858 0722 

F: +65 6885 0838 
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Technical Support 
T: +1 847 913 2259 
F: +1 847 913 2578 


Hardware: hwtsamerica@zebra.com 
Software: swtsamerica@zebra.com 


Europe, Africa, Middle East, and India 


Technical Support 


T: +44 (0) 1494 768298 

F: +44 (0) 1494 768210 

Germany: Tsgermany@zebra.com 
France: Tsfrance@zebra.com 
Spain/Portugal: Tsspain@zebra.com 
All other areas: Tseurope@zebra.com 


Technical Support 


T: +65 6858 0722 
F: +65 6885 0838 
E: tsasiapacific@zebra.com 


Customer Service Dept. 


For printers, parts, media, and ribbon, 
please call your distributor, or 
contact us. 

T: +1 866 230 9494 

E: VHCustServ@zebra.com 


Internal Sales Dept. 


For printers, parts, media, and ribbon, 
please call your distributor, or 
contact us. 

T: +44 (0) 1494 768316 

F: +44 (0) 1494 768244 

E: mseurope@zebra.com 


Customer Service 


For printers, parts, media, and ribbon, 
please call your distributor, or 
contact us. 

T: +65 6858 0722 

F: +65 6885 0837 
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Document Conventions 


Document Conventions 


| 
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The following conventions are used throughout this document to convey certain information. 
Alternate Color (online only) Cross-references contain hot links to other sections in this 
guide. If you are viewing this guide online in .pdf format, you can click the cross-reference 


(blue text) to jump directly to its location. 


Command Line Examples Command line examples appear in Courier New font. For 
example, type ZToo1s to get to the Post-Install scripts in the bin directory. 


Files and Directories File names and directories appear in Courier New font. For 
example, the Zebra<version number>.tar file andthe /root directory. 


Icons Used 


Important ¢ Advises you of information that is essential to complete a task. 


Note « Indicates neutral or positive information that emphasizes or supplements important 
points of the main text. 


Example « Provides an example, often a scenario, to better clarify a section of text. 


Illustration Callouts Callouts are used when an illustration contains information that needs 
to be labeled and described. A table that contains the labels and descriptions follows the 
graphic. Figure | provides an example. 


Figure 1 * Sample Figure with Callouts 


1 2 
|| 
ZPL Il CODE CODE 49 BAR CODE 
AXA 12345ABCDE 


“FO150,100*BY3 
AB4N,20,A,A 
AFD12345ABCDE*FS 
AXZ 


1 ZPL Code 


2 Generated Label 
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Introduction 


This guide is the unabridged, alphabetical reference of programming commands supported in 
the firmware. 


Firmware You can get the printer’s firmware version by printing out a configuration label. 
For instructions to do so, see your printer’s user guide. 


y 7 Note ¢ Firmware upgrades are available at: www.zebra.com. 


If you are using a previous version of Zebra printer firmware, some of the commands are the 
same and function as they did before— but equally as many are new and are not recognized by 
firmware earlier than X.10. 


Many word processors or a text editor capable of creating ASCII files can be used to recreate 
most examples in this guide. However, for other encodings such as Unicode, a text editor such 
as Microsoft Notepad is needed. 
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Notes « 
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ZPL Commands 


This section contains the complete alphabetical listing of ZPL I] commands. 


Description This heading provides an explanation of how the command is used, what it is 
capable of, and any defining characteristics it has. 


Format Format explains how the command is syntactically arranged and what parameters it 
contains. 


For Example The *88 command prints a EAN-8 bar code. The format of the *B8 
command is: *B80,h,f,g. It is arranged with the caret symbol (*), the command code 
(B8), and the parameters and are replaced with supported values. 


Parameters Ifacommand has values that can be defined to make its function more specific, 
these are outlined as parameters. Parameters typically have Accepted Values and Default 
Values. 


Still using the “B8 example, the h parameter is defined as: 


h = bar code height (in dots) 
Accepted Values: 1 to 32000 
Default Value: value set by “BY 


If the command has no parameters — for example ~ JA (Cancel All) — the parameter heading is 
removed, indicating that the format of the command (~JA) is acceptable ZPL II code. 
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4 | ZPL Commands 


——p»> Example ¢ When the command is best clarified in context, an example of the 
ZPL II code is provided. Text indicating exact code entered is printed in an easily 
recognizable Courier font. An example of code using the *B8 command looks like this: 


“XA 

“FO50, 50 
“B8N, 100,Y,N 
“FD1234567°FS 


“XZ 
Notice that the *B8 parameter letters have been replaced with real values that apply to the 
command. In this example N,100,Y,N have been entered. 


Comment This section is reserved for notes that are of value to a programmer, warnings of 
potential command interactions, or command-specific information that should be taken into 
consideration. 


——= > Example « An example comment is: This command works only when the printer is idle, 
or This command is ignored if a value exceeds the parameter limits. 


Comments are also included next to parameters if they apply directly to a particular setting. 
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ZPL Commands 
Basic ZPL Exercises and Examples 


Basic ZPL Exercises and Examples 


The purpose of these exercises is to introduce basic ZPL commands to novice ZPL users. 


Make sure this checklist is complete: 
Q) Load the printer with labels that are big enough to give you ample space to work with. 


Q) Print a configuration label (CANCEL test). 


QO) Look at the configuration label and make sure that the LEFT POSITION is set to 
000 and LABEL TOP is set to 000. 


) Determine the printer’s resolution. It is listed on the configuration label. 8/MM = 
200 dpi, 12/MM = 300 dpi and 24/MM = 600 dpi. 

Tips 

These are some tips when using ZPL: 


¢ Use the DOS text editor to write ZPL files. 


« Save the file as a .t xt file and copy it to the printer from DOS command line. 


Before you begin 


Some things that are important to understand before you begin are: 


¢ 200 dpi means the resolution of the printhead is 200 dots per inch. If you program the 
printer to draw a line 100 dots long that equals a half inch. 100 dots on a 
300 dpi printer prints a line 1/3 inch long. 


¢ The home position that all your coordinates are referencing is at the left-hand trailing edge 
of the label as the label comes out of the printer. (There are some exceptions to this.) 


Exercises 


The exercises start simple and gradually progress to give you an opportunity to try a variety of 
commonly used ZPL commands. Not all commands are covered, but this should be a good 
core of commands to learn. Some commands may not be supported due to the firmware 
version in your printer. 
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ZPL Commands 
Basic ZPL Exercises and Examples 


Exercise 1 * This exercise shows you how to specify a location for an entered name. 
1. Print your name on the label. 


2. Start by printing just your name on the label. Use this format as a model: 


Important * Your name goes where you see xkKxxxxxXxxxx in the second line of code. 


3. Send this format to the printer: 


1 ————_® xa 
2 ———— °F 050, 50°ADN, 36, 20* FDXxXxXXXXXXXXX 
3 ——— > *FS 
4 —_ > *XZ 


5 


Every format starts with the *XA command 
“FO (field origin) command 

“FS (field separator) command 

Every format ends with the *XZ command 
“FD (field data) command 


Ol BW) NP] & 


4. When the label prints correctly, alter the first number after the “FOx . See how that 
change affects the print position. Alter the second number after the *FO50, x and see 
how that the print position. 


Font instruction 
AADN 


1. Alter the numbers after the “ADN, x, x command. 
¢ 18,10 is the smallest size you can make the D font. 


¢ The first number is the height of the font in dots. The second number is the width in 
dots. 


* You can use direct multiples up to ten times that size as a maximum. 


——»> Example « 180,100 is the largest you can make the D font. 


¢ 25,18 would not be a valid size. The printer rounds to the next recognizable size. 


2. Check the font matrices tables for other fonts to try. See Fonts and Bar Codes 
on page 349. 


3. Try the zero scalable font “AON, x, x. 


This font is scalable, and you can choose any height and width. 
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Rotation commands 


1. Change “ADN to “ADR, and then “ADT, and then “ADB. 


See how the print position changes. 
2. Add more fields. 


3. Add two more fields to print directly under your name using the “ADN, 36, 20 font and 
size: 


Your street address 


Your city, state, zip 


4. You must add two more lines of code that start off with: 


“XA 

“FO50,50*ADN, 36, 20° FDXxxxxxXxxxxx*FS 
“FO (fill in the rest) 

“EO (fill in the rest) 

“XZ 


Make sure all these fields print in the same font and size and left side of fields has same 
vertical alignment. 


‘Your name 
1200 W Main Street 
Anytown, Il 60061 


Exercise 2 * Boxes and lines 
1. Use the address format from Exercise 1. 


2. Add this new line to your existing format: 
“FO50,200*GB200,200,2°FS 


This prints a box one wide by one inch long and the thickness of the line is 2 dots. 


3. Reposition and resize the square so that it goes around the name and address uniformly. 


4. Print a line by adding: 
“FO50,300*°GB400,0,4,°FS 


This prints a horizontal line two inches wide by 4 dots thick. 


5. Print a vertical line using this code: 
“F0100,50*GBO, 400, 4°FS 
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ZPL Commands 
Basic ZPL Exercises and Examples 


Exercise 3 


¢ Bar codes — *B3 code 39 bar code 


1. 


45541L-003 Rev. A 


Write the following format and send to the printer: 
“XA 
“FO50,50*B3N,N,100,Y,N*FD123456°FS 
“XZ 


. Try changing each of the parameters in the “B3 string so you can see the effects. 


Important ¢ For valid parameter choices, see “B3 on page 22. 


“B30 ;-6) hy fd 
“BY 


. Insert the “BY command just before the *“B3 to see how the narrow bar width can be 


altered. 


“FO50,50*°BY2*B3..etc *“BYx, acceptable values for x are 1 
through 10 


. Alter the ratio of the narrow to wide bar. 


“FO50,50*°BY2,3°B3..etc *BY2,x acceptable values for x are 
2.1 through 3 in .1 increments 


. Print out a *B3 bar code with the interpretation line on top of the bar code and the bar 


code rotated 90 degrees. 


. Add a “PQ just before the *XZ to print several labels. 


“PO4 
AXZ, 


“PR Print rate (in inches per second) 


. Adda “PR command after the *XA at the beginning of the format to change the print rate 


(print speed). 
“XA 


“PR4 then try *PR6 *PRx acceptable values for x are 2 through 
12 (check printer specs) 


See how the print speed affects the print quality of the bar code. You may need to increase 
the printer darkness setting at higher print speeds. 
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ZPL Commands 
Basic ZPL Exercises and Examples 


“SN — Serial Number command 


1. Send this format to the printer: 


“XA 

“FO100,100*ADN, 36,20*SN001,1,Y*EFS 

“PQ3 

“XZ 

To vary the *“SNv,n, z to exercise increment/decrement and leading zeros functions, 
consult this guide. 


If your serial number contains alpha and numeric characters, you can increment or 
decrement a specific segment of the data even if it is in the middle, as this sample 
sequence shows: 


ABCDLOOOEFGH, ABCDIOOLEFGH, ABCD1002EFGH 


. Send this file to the printer and to see how it increments the serial number. The *SF 


command can also work with alpha characters. 


“XA 

“FO100,100*ADN, 36, 20* FDABCD1000EFGH*SF%%%%dddd%%%%, 10000*FS 
“PQ15 

“XZ 


Notice how the field data character position aligns with the SF data string: 


= EF D A B Cc D 1 0) 0) 0) EB F G H 
“ S 6 |%6 |% |% d jd jd |% J%3 |% |% 
1 |0 JO |0 |0 
2 ;0 |}0 |0 JO 
3. /0 |O0 JO JO 
And on through... 


st a ae a a aa ae 


The last label prints ABCD1014EFGH. 


The % is placed in positions that you do not want to increment or decrement, 
= decimal, 10000 = increment value. 


For more details on “SF, see “SF on page 253. 
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10 | ZPL Commands 
Basic ZPL Exercises and Examples 


Exercise 5 ¢ Saving a template to memory. “IS and image save and image load. 


Note « This exercise helps you troubleshoot your code against the errors you see on your 
labels. 


1. Send this format to the printer: 
“XA 
“FO20,30°GB750,1100,4*FS 
“FO20,30°GB750,200,4°FS 
“FO20,30°GB750,400,4°FS 
“FO20,30°GB750,700,4°FS 
“FO20,226°GB325,204,4*FS 
“FO30, 40*ADN, 36,20*°FDShip to:*FS 
“FO30,260°ADN,18,10*FDPart number #*FS 
“FO360,260*ADN,18,10*FDDescription:*FS 
“FO30, 750*°ADN, 36, 20*°FDFrom: “FS 
“TSR: SAMPLE.GRF“*FS 
“XZ 


r 


2. Send this format: 
“XA 
“TLR: SAMPLE.GRFE“*FS 
“FO150,125*ADN, 36,20*FDAcme Printing*FS 
“FO60, 330°ADN, 36, 20*°FD14042“°FS 
“FO400, 330*°ADN, 36, 20*FDScrew*FS 
“FO70, 480*BY4°B3N, ,200*°FD12345678*FS 
“FO150, 800*ADN, 36,20*FDMacks Fabricating*FS 
“XZ 


r 


In this way the template only needs to be sent one time to the printer’s memory. Subsequent 
formats can be sent recalling the template and merging variable data into the template. In this 
exercise, the file was saved in the printers R: memory, which is volatile. 
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ZPL Commands 


Basic ZPL Exercises and Examples 


ADF and *XF — Download format and recall format 


Similar concept to *IS and *IL command. “IS and *1 
DF and “XF. 


nw 


This is how the “DF and “XF format structure produces a label similar to the *IS/*IL 


sample you just tried. 


[L processes faster in the printer than 


Figure 2 * Download and Recall Format 


ZPL Il CODE 


“XA 

“DFR: SAMPLE.GRF“FS 
“FO20,30°GB750,1100,4*°FS 
“FO20,30°GB750,200,4°FS 
“FO20,30°GB750, 400, 4*FS 
“FO20,30*°GB750, 700, 4*FS 
“FO20,226*°GB325,204,4°FS 

“FO30,40*°ADN, 36,20*FDShip to:*FS 
“FO30,260*ADN,18,10*FDPart number #*FS 
“FO360,260*°ADN,18,10*FDDescription:“*FS 
“F030, 750*ADN, 36, 20*FDFrom: *FS 
“FO150,125*ADN, 36,20*FN1*FS (ship to) 
“FO60,330°ADN, 36,20*°FN2“°FS (part num) 
“FO400, 330*ADN, 36, 20° FN3“FS (description) 
“FO70, 480*BY4*B3N, , 200*FN4“FS (barcode) 
“FO150, 800*ADN, 36,20*FN5S“*FS (from) 

AXZ 


“XA 

“XFR: SAMPLE.GRF 

“FN1*FDAcme Printing*FS 
“FN2*°FD14042*FS 
“AFN3“FDScrew*FS 
“FN4°FD12345678°FS 
“4FNS*FDMacks Fabricating*FS 
AXZ 


| [Ship to: 


Acme Printing 


Part number # 


14642 


From: 


GENERATED LABEL 


Description: 


Screw 


#123456 7oe 


Macks Fabricating 


1 Download format code 


2 | Recall format call that generates the generated 


label in Figure 2. 
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ZPL Commands 
A 


12 


AA 
Scalable/Bitmapped Font 


Description The *A command specifies the font to use in a text field. *A designates the font 
for the current “FD statement or field. The font specified by “A is used only once for that “FD 
entry. Ifa value for “A is not specified again, the default “CF font is used for the next “FD 
entry. 


Format “Af,o,h,w 


Important * Parameter £ is required. If £ is omitted it defaults to the last value of the *CF 
command. 


This table identifies the parameters for this format: 


Command Details 


f = font name Accepted Values: A through Z, and 0 to 9 

Any font in the printer (downloaded, EPROM, stored fonts, 
fonts A through Z and 0 to 9). 

o = field orientation | Accepted Values: 

N = normal 

R = rotated 90 degrees (clockwise) 


I = inverted 180 degrees 
B = read from bottom up, 270 degrees 
Default Value: the last accepted “FW value or the *FW default 


h = Character Height | Scalable 
(in dots) Accepted Values: 10 to 32000 
Default Value: last accepted “CF 
Bitmapped 


Accepted Values: multiples of height from 1 to 10 times the 
standard height, in increments of 1 


Default Value: last accepted “CF 


w = width (in dots) Scalable 
Accepted Values: 10 to 32000 
Default Value: last accepted “CF 
Bitmapped 
Accepted Values: multiples of width from 1 to 10 times the 
standard width, in increments of 1 
Default Value: last accepted “CF 
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Scalable Font Command 


——> Example « This is an example of a scalable font command: 
ZPL Il CODE GENERATED LABEL 

“XA 
AFO50, 50 ZEBRA 
“A0,32,25 
“FDZEBRA* FS PROGRAMMING 
“FO50,150 
eens LANGUAGE 
“FDPROGRAMMING“*FS 
“FO50,250 
“A0,32,25*FDLANGUAGE*FS 
“XZ 


Bitmap Font Command 


=> Example « This is an example of a bitmap font command: 

ZPL Il CODE GENERATED LABEL 
aA ZEBRA 
“FO50, 50 
“ADN, 36,20 
AFDZEBRA* FS PROGRAMMING 
“FO50,150 
“ADN, 36, 20 LANGUAGE 
“FDPROGRAMMING“‘F'S 
“FO50,250 
“ADN, 36, 20*FDLANGUAGE“FS 
“XZ 


For reference, see Standard Printer Fonts on page 350, Zebra Code Page 850 on page 340, 
Fonts and Bar Codes on page 349, and ASCI/ on page 345. 


Comments Fonts are built using a matrix that defines standard height-to-width ratios. If you 
specify only the height or width value, the standard matrix for that font automatically 
determines the other value. If the value is not given or a 0 (zero) is entered, the height or width 
is determined by the standard font matrix. 
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Description The *A@ command uses the complete name of a font, rather than the character 
designation used in “A. Once a value for *A@ is defined, it represents that font until a new 
font name is specified by “A@. 


Format *A@o,h,w,d:0.x 


This table identifies the parameters for this format: 


Parameters Details 


Accepted Values: 
N = 
R = rotates 90 degrees (clockwise) 

I = inverted 180 degrees 
B = read from bottom up, 270 degrees 

Default Value: N or the last “FW value 


o = field orientation 


normal 


Default Value: specifies magnification by w (character width) or 
the last accepted “CF value. Uses the base height if none is 
specified. 


h = character height 


(in dots) 


Scalable The value is the height in dots of the entire character 
block. Magnification factors are unnecessary, because 
characters are scaled. 

Bitmapped The value is rounded to the nearest integer 
multiple of the font’s base height, then divided by the font’s 
base height to give a magnification nearest limit. 


width (in dots) Default Value: specifies magnification by h (height) or the last 
accepted “CF value. Specifies the base width is used if none is 


specified. 


w= 


Scalable The value is the width in dots of the entire character 
block. Magnification factors are unnecessary, because 
characters are scaled. 

Bitmapped The value rounds to the nearest integer multiple 
of the font’s base width, then divided by the font’s base width 
to give a magnification nearest limit. 


d = drive location of 
font 
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Accepted Values: R:,E:,B:,and A: 
Default Value: R: 


ZPL Il Programming Guide For x.10 through x.13 Firmware 


6/9/06 


Parameters 


o = font name 


ZPL Commands | 15 
A@ 


Details 


Accepted Values: any valid font 
Default Value: if an invalid or no name is entered, the default set 
by “CF is used. If no font has been specified in “CF, font A is 
used. 
The font named carries over on all subsequent “A@ 
commands without a font name. 


extension 


* 
ll 


Example « This examp 


Accepted Values: 
-FNT = font 
.TTE = TrueType Font 


le is followed by a table that identifies the called out lines of code: 


ZPL Il CODE GENERATED LABEL 


“A@N, 50,50 


i. 


“FO100,100 


“A@N, 40, 40 
“FO100,150 


,B:CYRI_UB.FNT This uses B:CYRIUB.FNT 


“FDZebra Printer Fonts*FS 


“FDThis uses B:CYRI_UB.FNT*FS 


a 


Zebra Printer Fonts 


= 
on 
i “XZ 
a 


1 Starts the label format. 

2 Searches non-volatile printer memory (B:) for CYRI_UB.FNT. When 
the font is found, the “A@ command sets the print orientation to 
normal and the character size to 50 dots by 50 dots. 

3 Sets the field origin at 100,100. 

4 Prints the field data, Zebra Printer Fonts on the label. 

5 Calls the font again and character size is decreased to 40 dots by 40 
dots. 

6 Sets the new field origin at 100,150. 

7 Prints the field data, This uses the B:CYRI_UB.FNT on the label. 

8 Ends the label format. 


For reference, see Zebra 
ASCII on page 345. 


Code Page 850 on page 340, Fonts and Bar Codes on page 349, and 
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ABO 


“BO 


Aztec Bar Code Parameters 


Description The *BO command creates a two-dimensional matrix symbology made up of 
square modules arranged around a bulls-eye pattern at the center. 


Note « The Aztec bar code works with firmware V60.13.0.11A and higher. 


Format *B0a,b,c,d,e,f,9g 


This table identifies the parameters for this format: 


Parameters 


orientation 


a 


b = magnification 
factor 


Details 


Accepted Values: 
N = normal 
R = rotated 
I = inverted 180 degrees 


B = read from bottom up, 270 degrees 
Default Value: current “FW value 


Accepted Values: 1 to 10 
Default Value: 
1 on 150 dpi printers 
2 on 200 dpi printers 
3 on 300 dpi printers 
6 on 600 dpi printers 


c = extended channel 
interpretation 
code indicator 


Accepted Values: 

Y = if data contains ECICs 

N = if data does not contain ECICs 
Default Value: N 


d = error control and 
symbol size/type 
indicator 


Accepted Values: 
O = default error correction level 


01 to 99 = error correction percentage (minimum) 


101to104 = 


300 = asimple Aztec “Rune” 
Default Value: 0 


1 to 4-layer compact symbol 
201 to 232 = 1 to 32-layer full-range symbol 


€ = menu symbol 
indicator 
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Accepted Values: 


Y = if this symbol is to be a menu (bar code reader 


initialization) symbol 
N = if itis not a menu symbol 
Default Value: N 
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Parameters Details 

£ = number of Accepted Values: 1 through 26 
symbols for Default Value: 1 
structured 
append 


g = optionalID field | The ID field is a text string with 24-character maximum 
for structured Default Value: no ID 


append 
==> Example « This is an example of the *BO command: 
ZPL Il CODE GENERATED LABEL 
“XA 


“BUR, 7,N, Oy Ny 1,0 
“FD 7. This is testing label 7*FS 
“XZ 
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ZPL Commands 
ABI 


“Bl 
Code 11 Bar Code 


Description The *B1 command produces the Code 11 bar code, also known as USD-8 
code. In a Code 11 bar code, each character is composed of three bars and two spaces, and the 
character set includes 10 digits and the hyphen (-). 


* “B1 supports print ratios of 2.0:1 to 3.0:1. 


¢ Field data (“FD) is limited to the width (or length, if rotated) of the label. 


Format *Blo,e,h,f,g 


Important ¢ If additional information about the Code 11 bar code is required, go to 
www.aimglobal.org. 


This table identifies the parameters for this format: 


Parameters 


orientation 


[e) 


Details 


Accepted Values: 
N = normal 
R = rotated 90 degrees (clockwise) 


I = inverted 180 degrees 
B = read from bottom up, 270 degrees 
Default Value: current “FW value 


e = check digit 


h = bar code height 


Accepted Values: 
Y = 1 digit 
N 2 digits 
Default Value: N 
Accepted Values: 1 to 32000 


(in dots) Default Value: value set by “BY 
f = print Accepted Values: 
interpretation Y = yes 
line i = no 
Default Value: Y 
g = print Accepted Values: 
interpretation Y = yes 
line above code hose ae 


Default Value: N 
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=>» Example « This is an example of the Code 11 bar code: 
ZPL Il CODE CODE 11 BAR CODE 

“XA 

“FO100,100*BY3 

“BIN,N,150,Y,N 

“FD123456°FS 

AKT, 

21234568114 


CODE 11 BAR CODE CHARACTERS 
0 1 2 3 4 5 6 7 8 9 - 


Internal Start/Stop Character: A 


When used as a stop character: 


A is used with | check digit 
A is used with 2 check digits 
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ZPL Commands 
AB2 


“B2 


Interleaved 2 of 5 Bar Code 


Description The *B2 command produces the Interleaved 2 of 5 bar code, a high-density, 
self-checking, continuous, numeric symbology. 


Each data character for the Interleaved 2 of 5 bar code is composed of five elements: five bars 
or five spaces. Of the five elements, two are wide and three are narrow. The bar code is formed 
by interleaving characters formed with all spaces into characters formed with all bars. 


Format ~*1 


* “B2 supports print ratios of 2.0:1 to 3.0:1. 


¢ Field data (“FD) is limited to the width (or length, if rotated) of the label. 


B20,h,f,g,e,] 


Important ¢ If additional information about the Interleaved 2 of 5 bar code is required, go to 
www.aimglobal.org. 


This table identifies the parameters for this format: 


Parameters 


© = orientation 


Details 


Accepted Values: 
N = normal 
R = rotated 90 degrees (clockwise) 


I = inverted 180 degrees 
B = read from bottom up, 270 degrees 
Default Value: current “FW value 


h = barcode height 


Accepted Values: 1 to 32000 


(in dots) Default Value: value set by “BY 
f = print Accepted Values: 
interpretation Y = yes 
line N= no 
Default Value: Y 
g = print Accepted Values: 
interpretation Y = yes 
line above code ic = we 


Default Value: N 
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e = calculate and 
print Mod 10 
check digit 


Accepted Values: 
Y = yes 
N = no 


Default Value: N 
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AB2 
—=p> Example « This is an example of an Interleaved 2 of 5 bar code: 
ZPL Il CODE INTERLEAVED 2 OF 5 BAR CODE 
“XA 
“FO100,100*BY3 
“B2N,150,Y,N,N 
“FD123456°FS 
“XZ 
123456 
INTERLEAVED 2 OF 5 BAR CODE CHARACTERS 
0 1 2 3 4 p] 6 7 8 9 
Start/Stop (internal) 


Comments The total number of digits in an Interleaved 2 of 5 bar code must be even. The 
printer automatically adds a leading 0 (zero) if an odd number of digits is received. 


The Interleaved 2 of 5 bar code uses the Mod 10 check-digit scheme for error checking. For 
more information on Mod 10 check digits, see Mod 10 Check Digit on page 362. 
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ZPL Commands 
AB3 


“B3 
Code 39 Bar Code 


Description The Code 39 bar code is the standard for many industries, including the U.S. 
Department of Defense. It is one of three symbologies identified in the American National 
Standards Institute (ANSI) standard MH10.8M-1983. Code 39 is also known as USD-3 Code 


and 3 of 9 Code. 


Each character in a Code 39 bar code is composed of nine elements: five bars, four spaces, and 
an inter-character gap. Three of the nine elements are wide; the six remaining elements are 


nalrow. 


* “B3 supports print ratios of 2.0:1 to 3.0:1. 


¢ Field data (“FD) is limited to the width (or length, if rotated) of the label. 


* Code 39 automatically generates the start and stop character (*). 


¢ Asterisk (*) for start and stop character prints in the interpretation line, if the interpretation 


line is turned on. 


* Code 39 is capable of encoding the full 128-character ASCII set. 


Format *B30,e,h,f,9g,j,m,n 


Important ¢ If additional information about the Code 39 bar code is required, go to 


www.aimglobal.org. 


This table identifies the parameters for this format: 


Parameters 


© = orientation 


Details 


Accepted Values: 
N = normal 
R = rotated 90 degrees (clockwise) 


I = inverted 180 degrees 
B = read from bottom up, 270 degrees 
Default Value: current “FW value 


e = Mod-43 check 
digit 


Accepted Values: 
Y = yes 
N = no 

Default Value: N 


h = bar code height 
(in dots) 


Accepted Values: 1 to 32000 
Default Value: value set by “BY 
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Parameters Details 
f = print Accepted Values: 
interpretation Y = yes 
line N= no 
Default Value: Y 
g = print Accepted Values: 
interpretation Y = yes 
line above code it = ao 


—=> Example « This is an example of a Code 39 bar code: 


Default Value: N 


ZPL Il CODE 


CODE 39 BAR CODE 


“XA 


“FO100,100*BY3 


“B3N,N,100,Y,N 


“FD1I23ABC%FS 


“XZ 


#1 23ABCe 


CODE 39 BAR CODE CHARACTERS 


0 1 2 3 4 2) 9 
ABCDEFGHIJKLMNOPQRSTUVWXY Z 
- . $ f 


Comments Extended ASCII is a function of the scanner, not of the bar code. Your scanner 
must have extended ASCII enabled for this feature to work. To enable extended ASCII in the 
Code 39, you must first encode +$ in your “FD statement. To disable extended ASCII, you 

must encode -$ in your “FD statement. 


——p> Example « This example encodes a carriage return with line feed into a Code 39 bar code: 
ZPL Il CODE GENERATED LABELS 
“XA 
“FO20,20 


“B3N,N,100,Y 
“FDTEST+SSMSJ-S*FS 


“XZ 


#TEST+SSNSS-S% 
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‘B3 


Full ASCII Mode for Code 39 
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Code 39 can generate the full 128-character ASCII set using paired characters as shown in 


these tables: 


ASCII 


SOH 
STX 
ETX 
EOT 
ENQ 
ACK 
BEL 
BS 
HT 
LF 
VT 
FF 
CR 
so 
SI 
DLE 
DC1 
Dc2 
Dc3 
Dc4 
NAK 
SYN 
ETB 
CAN 
EM 
SUB 
ESC 
FS 
FS 
RS 
US 


Table 1 * Code 39 Full ASCII Mode 


Code 39 


$A 
$B 
$C 
$D 
$E 
$F 
$G 
$H 
$l 
$J 
$K 
$L 
$M 
$N 
$0 
$P 
$Q 
$R 
$S 
$T 
$U 
$V 
$wW 
$X 
$Y 
$Z 
AA 
%B 
AC 
%D 
AE 


ASCII 


NV il A+: 


Code 39 


Space 
/A 
/B 
IC 
/D 
/E 
IF 


— 


OHMNANARWNHAOG: 
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Table 2 « Code 39 Full ASCII Mode 


ZPL Commands 
AB3 


ASCII 


@ 


P4# —-GNXXS<KCHWHOWDOVOZERHAC-LOmMmMIIOAS 


Code 39 


%V 
A 


N<X<X&S<CHMOWOVOZZrFAcC-LTOmMMIOO 
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ASCII 


lCwH—- AN XK Fc cer HnsnQdnosds3gK-KTee-K-— TEA HDA AaAnD TDM 


DEL 


Code 39 


%W 
+A 
+B 
+C 
+D 
+E 
+F 
+G 
+H 

+l 
+J 
+K 
+L 
+M 
+N 
+0 
+P 
+Q 
+R 
+S 
+T 
+U 
+V 
+W 
+X 
+Y 
4Z 
%P 

%Q 
%R 
%S 

%T, %X 
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“B4 


Code 49 Bar Code 
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Description The *B4 command creates a multi-row, continuous, variable-length 
symbology capable of encoding the full 128-character ASCII set. It is ideally suited for 
applications requiring large amounts of data in a small space. 


The code consists of two to eight rows. A row consists of a leading quiet zone, four symbol 
characters encoding eight code characters, a stop pattern, and a trailing quiet zone. A separator 
bar with a height of one module separates each row. Each symbol character encodes two 
characters from a set of Code 49 characters. 


* “B4 has a fixed print ratio. 


¢ Rows can be scanned in any order. 


Format *B4o0,h,£,m 


Important ¢ For additional information about the Code 49 bar code is required, go to 
www.aimglobal.org. 


This table identifies the parameters for this format: 


Parameters Details 


© = orientation Accepted Values: 
N = normal 
R = rotated 90 degrees (clockwise) 


I = inverted 180 degrees 
B = read from bottom up, 270 degrees 
Default Value: current “FW value 


h = height multiplier | Accepted Values: 1 to height of label 
of individual Default Value: value set by “BY 


a This number multiplied by the module equals the height of the 
individual rows in dots. 1 is not a recommended value. 
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Parameters 

f = print 
interpretation 
line 


ZPL Commands 
AB4 


Details 


Accepted Values: 
N 
A = print interpretation line above code 


no line printed 


B = print interpretation line below code 

Default Value: N 
When the field data exceeds two rows, expect the 
interpretation line to extend beyond the right edge of the bar 
code symbol. 


m = starting mode 


Accepted Values: 

O = Regular Alphanumeric Mode 
= Multiple Read Alphanumeric 
= Regular Numeric Mode 
= Group Alphanumeric Mode 
= Regular Alphanumeric Shift 1 
= Regular Alphanumeric Shift 2 


Pow WN BE 
| 


= Automatic Mode. The printer determines the starting 
mode by analyzing the field data. 


Default Value: A 


Example « This is an example of a Code 49 bar code: 


ZPL Il CODE CODE 49 BAR CODE 


“XA 


“XZ 


“FO150,100*BY3 
AB4N,20,A,A 
AFD12345ABCDE*FS 


123435ABCUE 
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Table 3 * Code 49 


Field Data Unshifted Shift 1 Shift 2 
Set Character Set Character Set Character Set 


0 


w 
n 
NK xXS<Ce#HnQT053353-KA~-—-TFEaRDAOAOTHMOG-H-Ovvill a-- 


(IN<KXS<CHMWDOVOZER-AC-LOMMVINDDSFOONANARWNH=AO0 
IN<XKXS<CHNWOVOZZEFAC-LOMMINODFOMVNMAGAWN= 
a] 
Li | 


SPACE SPACE Null D 


t~——~ mM - 


% % reserved 


= (Numeric Shift) 
Code 49 Shift 1 and 2 Character Substitutions 
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Code 49 Field Data Character Set 


The “FD data sent to the printer when using starting modes 0 to 5 is based on the 
Code 49 Internal Character Set. This is shown in the first column of the Code 49 table on the 
previous page. These characters are Code 49 control characters: 

<P se 


Valid field data must be supplied when using modes 0 to 5. Shifted characters are sent as a 
two-character sequence of a shift character followed by a character in the unshifted character 
set. 


== Example « To encode a lowercase a, send a > (Shift 2) followed by an uppercase A. If 
interpretation line printing is selected, a lowercase a prints in the interpretation line. This 
reflects what the output from the scanner reads. Code 49 uses uppercase alphanumeric 
characters only. 


If an invalid sequence is detected, the Code 49 formatter stops interpreting field data and prints 
a symbol with the data up to the invalid sequence. These are examples of invalid sequences: 


¢ Terminating numeric mode with any characters other than 0 to 9 or a Numeric Space. 


¢ Starting in Mode 4 (Regular Alphanumeric Shift 1) and the first field data character is 
not in the Shift 1 set. 


¢ Starting in Mode 5 (Regular Alphanumeric Shift 2) and the first field data character is 
not in the Shift 2 set. 


¢ Sending Shift 1 followed by a character not in the Shift 1 set. 
¢ Sending Shift 2 followed by a character not in the Shift 2 set. 
¢ Sending two Shift 1 or Shift 2 control characters. 


Advantages of Using the Code 49 Automatic Mode 


Using the default (Automatic Mode) completely eliminates the need for selecting the starting 
mode or manually performing character shifts. The Automatic Mode analyzes the incoming 
ASCII string, determines the proper mode, performs all character shifts, and compacts the data 
for maximum efficiency. 


Numeric Mode is selected or shifted only when five or more continuous digits are found. 


Numeric packaging provides no space advantage for numeric strings consisting of fewer than 
eight characters. 
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“B5 


Planet Code bar code 


Description The *B5 command is supported in all printers as a resident bar code. 


Format *B50,h,f,g 


Note « Accepted bar code characters are 0 - 9. 


This table identifies the parameters for this format: 


Parameters Details 
Oo = orientation code | Accepted Values: 
N = normal 
R rotated 
I inverted 180 degrees 
B = read from bottom up, 270 degrees 


Default Value: current *F'W value 


h = barcode height 


Accepted Values: 1 to 9999 


(in dots) Default Value: value set by “BY 
f£ = interpretation Accepted Values: 
line N = no 
Y yes 
Default Value: N 
g = determinesifthe | Accepted Values: 
interpretation N no 
line is printed Y yes 
above the bar 


code 


Default Value: N 


Example ¢ This is an example of a Planet Code bar code: 


ZPL Il CODE 


GENERATED LABEL 


“XA 
“FO150,100*BY3 
“B5N,100,Y,0 
“FD12345678901°FS 
“XZ 


WA lc 
12345673981 
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“B7 
PDF417 Bar Code 


Description The *B7 command produces the PDF417 bar code, a two-dimensional, 
multirow, continuous, stacked symbology. PDF417 is capable of encoding over 

1,000 characters per bar code. It is ideally suited for applications requiring large amounts of 
information at the time the bar code is read. 


The bar code consists of three to 90 stacked rows. Each row consists of start and stop patterns 
and symbol characters called code-words. A code-word consists of four bars and four spaces. 
A three code-word minimum is required per row. 


The PDF417 bar code is also capable of using the structured append option (“FM), which 
allows you to extend the field data limitations by printing multiple bar codes. For more 
information on using structured append, see “FM on page 142. 


¢ PDF417 has a fixed print ratio. 
¢ Field data(*FD) is limited to 3K of character data. 


Format *B7o0,h,s,c,xr,t 


This table identifies the parameters for this format: 


Parameters Details 


© = orientation Accepted Values: 


N = normal 
R = rotated 90 degrees (clockwise) 


I = inverted 180 degrees 
B = read from bottom up, 270 degrees 
Default Value: current “FW value 


h = barcode height | Accepted Values: 1 to height of label 


for individual Default Value: value set by *BY 
rows (in dots) 


This number multiplied by the module equals the height of the 
individual rows in dots. 1 is not a recommended value. 


Ss = security level Accepted Values: 1 to 8 (error detection and correction) 

Default Value: 0 (error detection only) 
This determines the number of error detection and correction 
code-words to be generated for the symbol. The default level 
provides only error detection without correction. Increasing 
the security level adds increasing levels of error correction 
and increases the symbol size. 


c = numberofdata | Accepted Values: 1 to 30 


columns to Default Value: 1 : 2 (row-to-column aspect ratio) 


encode You can specify the number of code-word columns giving 


control over the width of the symbol. 
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Parameters 


rx = number of rows 
to encode 


Details 


Accepted Values: 3 to 90 

Default Value: 1:2 (row-to-column aspect ratio) 
You can specify the number of symbol rows giving control 
over the height of the symbol. For example, with no row or 
column values entered, 72 code-words would be encoded into 
a symbol of six columns and 12 rows. Depending on code- 
words, the aspect ratio is not always exact. 


45541L-003 Rev. A 


t = truncate right Accepted Values: 
row indicators N = no truncation 
and stop pattern Y = perform truncation 


Default Value: N 


Example « This is an example of a PDF417 bar code: 


ZPL Il CODE PDF417 BAR CODE 


“XA 

“BY2,3 
“FO10,10*B7N,5,5,,83,N 
“FDZebra Technologies 
Corporation strives to be 
the expert supplier of 
innovative solutions to 
speciality demand labeling 
and ticketing problems of 
business and government. 
We will attract and retain 
the best people who will 
understand our customer's 
needs and provide them with 
systems, hardware, software, 
consumables and service 
offering the best value, 
high quality, and reliable 
performance, all delivered 
in a timely manner. 

“FS*XZ 
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Example « This is an example of a PDF417 without and with truncation selected: 


t ne 

H | 

Hata | 
1 


a 


wey 


t 
t 


i 


' 
i 
i 
: f 


ie 


PDF417 with Truncation being selected 


Example « This example shows the *B7 command used with field hex (“ FH) characters: 


ZPL Il CODE GENERATED LABEL 


AXA 
“FO50.,,50°BY3;-3...0°BIN,8;5;-7,21,N 
“FH _*FD[)>_1E06_1DP12345678 1DQ160 hint wy 
| 3 
H 4 
! ee ea 


_1D1JUN123456789A2B4C6D8E 1D20LA6-987 
—1D211L54321 ZES_1D15KG1155 
_1DBSC151208 1D7Q10GT_1E 04%FS 

“XZ 


Comments Noted in this bulleted list: 
¢ If both columns and rows are specified, their product must be less than 928. 
¢ No symbol is printed if the product of columns and rows is greater than 928. 


* No symbol is printed if total code-words are greater than the product of columns and rows. 


Serialization is not allowed with this bar code. 


¢ The truncation feature can be used in situations where label damage is not likely. The right 
row indicators and stop pattern is reduced to a single module bar width. The difference 
between a non truncated and a truncated bar code is shown in the previous examples. 
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Special Considerations for *~By When Using PDF417 


When used with *B7, the parameters for the *BY command are: 
w = module width (in dots) 
Accepted Values: 2 to 10 
Default Value: 2 
r = ratio 
Fixed Value: 3 (ratio has no effect on PDF417) 
h = height of bars (in dots) 
Accepted Values: 1 to 32000 
Default Value: 10 
PDF417 uses this only when row height is not specified in the “B7 h parameter. 


Special Considerations for *fD When Using PDF417 


The character set sent to the printer with the *FD command includes the full ASCH set, except 
for those characters with special meaning to the printer. 


See Zebra Code Page 850 on page 340, “CC ~CC on page 107, and “CT ~CT on page 118. 


¢ CR and LF are also valid characters for all “FD statements. This scheme is used: 
\& = carriage return/line feed 
\\ = backslash (\) 


* “C113 must be selected to print a backslash (\). 
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A 
B8 
EAN-8 Bar Code 
Description The *B8 command is the shortened version of the EAN-13 bar code. EAN is 


an acronym for European Article Numbering. Each character in the EAN-8 bar code is 
composed of four elements: two bars and two spaces. 


* “B8 supports a fixed ratio. 


¢ Field data (“FD) is limited to exactly seven characters. ZPL II automatically pads or 
truncates on the left with zeros to achieve the required number of characters. 


« When using JAN-8 (Japanese Article Numbering), a specialized application of EAN-8, 
the first two non-zero digits sent to the printer are always 49. 


Format *B80,h,f,g 


Important ¢ If additional information about the EAN-8 bar code is required, go to 
www.aimglobal.org. 


This table identifies the parameters for this format: 


Parameters Details 


© = orientation Accepted Values: 
N = normal 
R = rotated 90 degrees (clockwise) 


I = inverted 180 degrees 
B = read from bottom up, 270 degrees 
Default Value: current “FW value 


h = barcode height | Accepted Values: 1 to 32000 


(in dots) Default Value: value set by “BY 
f = print Accepted Values: 

interpretation N = no 

line Y = yes 


Default Value: Y 


g = print Accepted Values: 
interpretation N = no 
line above code Y = yes 


Default Value: N 
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Example « This is an example of an EAN-8 bar code: 


ZPL Il CODE 


EAN-8 BAR CODE 


“XA 
“FO100,100*BY3 
“B8N,100,Y,N 
“FD1234567°FS 
“XZ 


1 


234°5670 


EAN-8 BAR CODE CHARACTERS 


0 1 2 


3 


4 


2) 


6 


7 8 9 
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Description The *B9 command produces a variation of the UPC symbology used for 
number system 0. It is a shortened version of the UPC-A bar code, where zeros are suppressed, 
resulting in codes that require less printing space. The 6 dot/mm, 

12 dot/mm, and 24 dot/mm printheads produce the UPC and EAN symbologies at 

100 percent of their size. However, an 8 dot/mm printhead produces the UPC and EAN 
symbologies at a magnification factor of 77 percent. 


Each character in a UPC-E bar code is composed of four elements: two bars and two spaces. 
The “BY command must be used to specify the width of the narrow bar. 


* “B9 supports a fixed ratio. 


¢ Field data (*FD) is limited to exactly 10 characters, requiring a five-digit manufacturer’s 
code and five-digit product code. 


« When using the zero-suppressed versions of UPC, you must enter the full 
10-character sequence. ZPL II calculates and prints the shortened version. 


Format *B9,h,f,g,e 


Important ¢ If additional information about the UPC-E bar code is required, go to 
www.aimglobal.org. 


This table identifies the parameters for this format: 


Parameters Details 


fe) orientation Accepted Values: 

N = normal 

R = rotated 90 degrees (clockwise) 

I = inverted 180 degrees 

B = read from bottom up, 270 degrees 


Default Value: current “FW value 


h = barcode height | Accepted Values: 1 to 32000 
(in dots) Default Value: value set by “BY 
f = print Accepted Values: 
interpretation N = no 
line Y = yes 


Default Value: Y 
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‘BO 
Parameters Details 
g = print Accepted Values: 
interpretation N = no 
line above code Y = yes 
Default Value: N 
e = print check digit | Accepted Values: 
N = no 
Y = yes 
Default Value: Y 
==> Example « This is an example of a UPC-E bar code: 
ZPL Il CODE UPC-E BAR CODE 
“XA 
“FO150,100*BY3 
“BON, 100,Y,N,Y 
“FD1230000045*FS 
“XZ 1234531 


UPC-E BAR CODE CHARACTERS 
0 1 2 3 4 5 6 7 8 9 


Rules for Proper Product Code Numbers 


¢ Ifthe last three digits in the manufacturer’s number are 000, 100, or 200, valid product 
code numbers are 00000 to 00999. 


« Ifthe last three digits in the manufacturer’s number are 300, 400, 500, 600, 700, 800, or 
900, valid product code numbers are 00000 to 00099. 


¢ Ifthe last two digits in the manufacturer’s number are 10, 20, 30, 40, 50, 60, 70, 80, or 90, 
valid product code numbers are 00000 to 00009. 


¢ Ifthe manufacturer’s number does not end in zero (0), valid product code numbers are 
00005 to 00009. 
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ABA 
Code 93 Bar Code 


Description The *BA command creates a variable length, continuous symbology. The Code 
93 bar code is used in many of the same applications as Code 39. It uses the full 128-character 
ASCII set. ZPL II, however, does not support ASCII control codes or escape sequences. It uses 
the substitute characters shown below. 


Control Code ZPL Il Substitute 
Ctrl $ & 
Ctrl % ‘ 
Ctrl / ( 
Ctrl + ) 


Each character in the Code 93 bar code is composed of six elements: three bars and three 
spaces. Although invoked differently, the human-readable interpretation line prints as though 
the control code has been used. 


¢ “BA supports a fixed print ratio. 
¢ Field data (“FD) is limited to the width (or length, if rotated) of the label. 


Format *BAo,h,f,g,e 


Important « If additional information about the Code 93 bar code is required, go to 
www.aimglobal.org. 


This table identifies the parameters for this format: 


Parameters Details 


© = orientation Accepted Values: 
N = normal 
R = rotated 90 degrees (clockwise) 


I = inverted 180 degrees 
B = read from bottom up, 270 degrees 
Default Value: current “FW value 


h = barcode height | Accepted Values: 1 to 32000 


(in dots) Default Value: value set by “BY 
f = print Accepted Values: 

interpretation N = no 

line Y = yes 


Default Value: Y 
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Parameters Details 
g = print Accepted Values: 
interpretation N = no 
line above code Y = yes 
Default Value: N 
e = print check digit | Accepted Values: 
N = no 
Y = yes 
Default Value: N 


Example « This is an example of a Code 93 bar code: 


CODE 93 BAR CODE ZPL Il CODE 
“XA 
“FO100, 75*BY3 
“BAN, 100,Y,N,N 
“FD12345ABCDE*FS 
Oi2345ABCDE0 hay 


CODE 93 BAR CODE CHARACTERS 


ABC 


0 je &2 #4 & Gé 8 (9 
DEFGHIJKLMNOPQRS TUVWXYZ 
- i & f+ % & * € 3 
SPACE 


O Denotes an internal start/stop character that must precede and follow 
every bar code message. 


Comments 


All control codes are used in pairs. 


Code 93 is also capable of encoding the full 128-character ASCII set. For more details, see 
Table 4 on page 41. 


Full ASCII Mode for Code 93 
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Code 93 can generate the full 128-character ASCII set using paired characters as shown in 
Table 4 on page 41. 
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ASCII 


NUL 
SOH 
STX 
ETX 
EOT 
ENQ 
ACK 
BEL 
BS 
HT 
LF 
VT 
FF 
CR 
SO 
SI 
DLE 
DC1 
DC2 
DC3 
DC4 
NAK 
SYN 
ETB 
CAN 
EM 
SUB 
ESC 
FS 
FS 
RS 
US 


Code 93 
U 
&A 
&B 
&C 
&D 
&E 
&F 
&G 
&H 
&l 
&J 
&K 
&L 
&M 
&N 
&O 
&P 
&Q 
&R 
&S 
&T 
&U 
&V 
&W 
&X 
&Y 
&Z 
‘A 
‘B 
cc 
‘D 
= 


ASCII 
sP 


OANODOARWNAO™~: 


NOV I Aste 


Code 93 


Space 


> 


ITOAMOOD 


tos 


= 
= 


TINOANOORWNHAO~-: 
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Table 5 « Code 93 Full ASCII Mode 


ASCII Code 93 ASCII Code 93 


P44 -GNXXSKCHHODOVOZZrFAC-LOTMMIOVFE 
lIw—- ONC XK SEK Cer ns Qvodoodsgyg-xRXr---—-TaAAD AA TD 
re) 


OZZFRNKXEK<KCHHODMOVOZEZr-AcC-TOmMIINFSY 


0 
m 
- 
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CODABLOCK Bar Code 


Description The *BB command produces a two-dimensional, multirow, stacked 
symbology. It is ideally suited for applications that require large amounts of information. 


Depending on the mode selected, the code consists of one to 44 stacked rows. Each row begins 
and ends with a start and stop pattern. 


* CODABLOCK A supports variable print ratios. 
* CODABLOCK E and F support only fixed print ratios. 


Format *BBo,h,s,c,r,m 


Important ¢ If additional information about the CODABLOCK bar code is required, go to 


www.aimglobal.org. 


This table identifies the parameters for this format: 


Parameters 


© = orientation 


Details 


Accepted Values: 
N = normal 
R = rotated 90 degrees (clockwise) 


I = inverted 180 degrees 
B = read from bottom up, 270 degrees 
Default Value: N 


h = bar code height 
for individual 
rows (in dots) 


Accepted Values: 2 to 32000 

Default Value: 8 
This number, multiplied by the module, equals the height of 
the individual row in dots. 


Ss = security level 


Accepted Values: 
N = no 
Y = yes 
Default Value: Y 


Security level determines whether symbol check-sums are 
generated and added to the symbol. Check sums are never 
generated for single-row symbols. This can be turned off only 
if parameter m is set to A. 


c = number of 
characters per 
row (data 
columns) 
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you control over the width of the symbol. 
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Parameters Details 


x = number ofrows | Accepted Values: 
to encode for CODABLOCK A: 1 to 22 
for CODABLOCK E and F: 2 to 4 


« Ifvalues for c and rare not specified, a single row is 
produced. 


¢ Ifa value for r is not specified, and c exceeds the 
maximum range, a single row equal to the field data 
length is produced. 


¢ Ifa value for c is not specified, the number of characters 
per row is derived by dividing the field data by the value 
of r. 


¢ Ifboth parameters are specified, the amount of field data 
must be less than the product of the specified parameters. 
If the field data exceeds the value of the product, either 
no symbol or an error code is printed (if “CV is active). 


¢ Ifthe data field contains primarily numeric data, fewer 
than the specified rows might be printed. If the field data 
contains several shift and code-switch characters, more 
than the specified number of rows might be printed. 


m = mode Accepted Values: A, E, F 
CODABLOCK A uses the Code 39 character set. 
CODABLOCK F uses the Code 128 character set. 


CODABLOCK E uses the Code 128 character set and 
automatically adds FNC1. 


Default Value: F 
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Example « This is an example of aCODABLOCK bar code: 
CODABLOCK BAR CODE ZPL Il CODE 
“XA 
“BY2,3 
| “FO10,10*°BBN, 30,,30,44,E 


“FDZebra Technologies 
Corporation strives to be 
the expert supplier of 
innovative solutions to 
speciality demand labeling 
and ticketing problems of 
business and government. 

We will attract and retain 
the best people who will 
understand our customer's 
needs and provide them with 
systems, hardware, software, 
consumables and service 
offering the best value, 
high quality, and reliable 
performance, all delivered 
in a timely manner.*FS 

“XZ 


Special Considerations for the “BY Command When Using *BB 


The parameters for the *~BYw, r, h command, when used with a “BB code, are as follows: 

w = module width (in dots) 

Accepted Values: 2 to 10 (CODABLOCK A only) 

Default Value: 2 
r = ratio 

Fixed Value: 3 (ratio has no effect on CODABLOCK E or F) 
h = height of bars (in dots) 

Accepted Values: 1 to 32, 32000 

Default Value: 10 


CODABLOCK uses this as the overall symbol height only when the row height is not 
specified in the “BB h parameter. 


Special Considerations for “FD Character Set When Using “BB 


The character set sent to the printer depends on the mode selected in parameter m. 


CODABLOCK A: CODABLOCK A uses the same character set as Code 39. If any other 
character is used in the “FD statement, either no bar code is printed or an error message is 
printed (if “CV is active). 


CODABLOCK E: The Automatic Mode includes the full ASCII set except for those 
characters with special meaning to the printer. Function codes or the 
Code 128 Subset A <nul> character can be inserted using of the “FH command. 
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<fncl> = 80 hex <fnc3> = 82 hex 
<fnc2> = 81 hex <fnc4> = 83 hex 
<nul> = 84 hex 


For any other character above 84 hex, either no bar code is printed or an error message is 
printed (if “CV is active). 


CODABLOCK F: CODABLOCK F uses the full ASCII set, except for those characters 
with special meaning to the printer. Function codes or the Code 128 Subset A <nul> 
character can be inserted using of the “FH command. 


<fncl> = 80 hex <fnc3> = 82 hex 
<fnc2> = 81 hex <fnc4> = 83 hex 
<nul> = 84 hex 
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“BC 
Code 128 Bar Code (Subsets A, B, and C) 


Description The “BC command creates the Code 128 bar code, a high-density, variable 
length, continuous, alphanumeric symbology. It was designed for complexly encoded product 
identification. 


Code 128 has three subsets of characters. There are 106 encoded printing characters in each 
set, and each character can have up to three different meanings, depending on the character 
subset being used. Each Code 128 character consists of six elements: three bars and three 
spaces. 


* “BC supports a fixed print ratio. 


¢ Field data (“FD) is limited to the width (or length, if rotated) of the label. 


Format *BCo,h,f,g,e,m 


Important « If additional information about the Code 128 bar code is required, go to 
www.aimglobal.org. 


This table identifies the parameters for this format: 


Parameters Details 


© = orientation Accepted Values: 
N = normal 
R = rotated 90 degrees (clockwise) 


I = inverted 180 degrees 
B = read from bottom up, 270 degrees 
Default Value: current “FW value 


h = barcode height | Accepted Values: 1 to 32000 


(in dots) Default Value: value set by “BY 

f = print Accepted Values: Y (yes) or N (no) 
interpretation Default Value: Y 
line 


The interpretation line can be printed in any font by placing 
the font command before the bar code command. 


g = print Accepted Values: Y (yes) or N (no) 


interpretation Default Value: N 
line above code 
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Parameters 
e = UCC check digit 
m = mode 


Details 


Accepted Values: Y (turns on) or N (turns off) 


Mod 103 check digit is always there. It cannot be turned on or 
off. Mod 10 and 103 appear together with e turned on. 
Default Value: N 


Accepted Values: 


N 
U 


A 


= no selected mode 
= UCC Case Mode 


More than 19 digits in “FD or “SN are eliminated. 


Fewer than 19 digits in “FD or “SN add zeros to the right 
to bring the count to 19. This produces an invalid 
interpretation line. 


= Automatic Mode 


This analyzes the data sent and automatically 
determines the best packing method. The full ASCII 
character set can be used in the “FD statement — the 
printer determines when to shift subsets. A string of 
four or more numeric digits causes an automatic shift to 
Subset C. 


= UCC/EAN Mode (x.11.x and newer firmware) 


This allows dealing with UCC/EAN with and without 
chained application identifiers. The code starts in the 
appropriate subset followed by FNC1 to indicate a 
UCC/EAN 128 bar code. The printer automatically 
strips out parentheses and spaces for encoding, but 
prints them in the human-readable section. The printer 
automatically determines if a check digit is required, 
calculate it, and print it. Automatically sizes the human 
readable. 


Default Value: N 


Example « This is an example of a Code 128 bar code: 


CODE 128 BAR CODE ZPL Il CODE 


“XA 

“FO100,100*BY3 

“BCN,100,Y,N,N 

“FD123456°FS 
123456 
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Code 128 Subsets 


The Code 128 character subsets are referred to as Subset A, Subset B, and Subset C. A subset 
can be selected in these ways: 


¢ A special Invocation Code can be included in the field data (* FD) string associated with 
that bar code. 


¢ The desired Start Code can be placed at the beginning of the field data. If no Start Code is 
entered, Subset B are used. 


To change subsets within a bar code, place the Invocation Code at the appropriate points 
within the field data (“FD) string. The new subset stays in effect until changed with the 
Invocation Code. For example, in Subset C, >7 in the field data changes the Subset to A. 


Table 6 shows the Code 128 Invocation Codes and Start Characters for the three subsets. 


Table 6 * Code 128 Invocation Characters 


Invocation Decimal Subset A Subset B Subset C 
Code Value Character Character Character 
>< 62 
>0 30 > > 
>= 94 ~ 
>I 95 USQ DEL 
>2 96 FNC 3 FNC 3 
>3 97 FNC 2 FNC 2 
>4 98 SHIFT SHIFT 
>5 99 CODE C CODE C 
>6 100 CODE B FNC 4 CODE B 
>7 101 FNC 4 CODEA CODE A 
>8 102 FNC 1 FNC 1 FNC 1 
Start Characters 
>9 103 Start Code A (Numeric Pairs give Alpha/Numerics) 
> 104 Start Code B (Normal Alpha/Numeric) 
>: 105 Start Code C (All numeric (00 - 99) 


ZPL Il Programming Guide For x.10 through x.13 Firmware 45541L-003 Rev. A 


50 | ZPL Commands 
ABC 


Table 7 shows the character sets for Code 128: 


Table 7 * Code 128 character sets 


Value Code A Code B Value Code A Code B 
SP SP 


>4 EON KM ESC 


OAANIADMNAHWNK CO 


nung 
sod uw—-—oN 
Es > <xe<c 


OANINDMNABRWNH Om 


Vil Av 


a 
b 
c 
d 
e 
f 
g 
h 
i 
j 
k 
1 
m 
n 
0 
P 
q 
Fs 
s 
t 
u 
v 
Ww 
x 
y 
Z 
t 
| 
} 


DEL 
FNC3 
FNC2 
SHIFT 

Code C 
FNC4 
Code A 
FNC1 
START (Code A) 
START (Code B) 
START (Code C) 


HANZAOVOAZZMHAHHTOAAMOIOWDrFOarVi As: 


HnNAPOVOAZZrMAs4+TAAMIADFrO 
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of switching from Subset C to B to A, as follows: 
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CODES 


“XA 


“XZ 


“FO100,75 
“BCN,100,Y,N,N 
“FDCODE128%*FS 


Figure A: Subset B with no start character 


CODES 


“XA 


“XZ 


“FO100,75 
“BCN,100,Y,N,N 
“FD>:CODE128“°FS 


Figure B: Subset B with start character 


Because Code 128 Subset 
subset, ZPL 


defaults to Subset 


is specified in the data string. 


B is the most commonly used 
B if no start character 


382436CODE128TEST 


“XA 
“FO50,50 
“BY3°BCN,100,Y,N 


,N 
B128>752375152°FS 


“FD>;382436>6COD! 
“XZ 


Figure C: Switching from Subset C toBtoA 


How “BC Works Within a ZPL Il Script 


“XA — the first command starts the label format. 


“FO100,75 —the second command sets the field origin at 100 dots across the x-axis and 75 


dots down the y-axis from the upper-left corner. 


“BCN,100,Y,N,N — the third command calls for a Code 128 bar code to be printed with 
no rotation (N) and a height of 100 dots. An interpretation line is printed (Y) below the bar 


code (N). No UCC check digit is used (N). 


“FDCODE128“FS (Figure A) *FD>: COD! 


specifies the content of the bar code. 


E128%FS (Figure B) — the field data command 


“XZ — the last command ends the field data and indicates the end of the label. 


The interpretation line prints below the code with the UCC check digit turned off. 
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The “FD command for Figure A does not specify any subset, so Subset B is used. In Figure B, 
the *FD command specifically calls Subset B with the >: Start Code. Although ZPL II defaults 
to Code B, it is good practice to include the Invocation Codes in the command. 


Code 128 — Subset B is programmed directly as ASCII text, except for values greater than 94 
decimal and a few special characters that must be programmed using the invocation codes. 
Those characters are: 

ra > ae 


—— > Example « Code 128 — Subsets A and C 


Code 128, Subsets A and C are programmed in pairs of digits, 00 to 99, in the field data 
string. For details, see Zable 6 on page 49. 


In Subset A, each pair of digits results in a single character being encoded in the bar code; in 
Subset C, characters are printed as entered. Figure E below is an example of Subset A (>9 is 
the Start Code for Subset A). 


Nonintegers programmed as the first character of a digit pair (D2) are ignored. However, 
nonintegers programmed as the second character of a digit pair (2D) invalidate the entire 
digit pair, and the pair is ignored. An extra unpaired digit in the field data string just before a 
code shift is also ignored. 


Figure C and Figure D below are examples of Subset C. Notice that the bar codes are 
identical. In the program code for Figure D, the D is ignored and the 2 is paired with the 4. 


AXA 

“FOL00, 75*BY3 

ABCN,100,Y,N,N 
“FD>;382436°FS 


oo2436 ne 


Figure C: Subset C with normal data 


AXA 

“FO100, 75*BY3 

ABCN,100,Y,N,N 

AFD>; 38D2436*FS 
Soe 456 : 


XZ 


Figure D: Subset C with ignored alpha character 


AXA 

“FOL00, 75*BY3 

ABCN,100,Y,N,N 

AFD>935473637171824°FS 
CODE AXY, 


Figure E: Subset A 
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The UCC/EAN-128 Symbology 


The symbology specified for the representation of Application Identifier data is UCC/EAN- 
128, a variant of Code 128, exclusively reserved to EAN International and the Uniform Code 
Council (UCC). 


Note « It is not intended to be used for data to be scanned at the point of sales in retail outlets. 


UCC/EAN-128 offers several advantages. It is one of the most complete, alphanumeric, one- 
dimensional symbologies available today. The use of three different character sets (A, B and 
C), facilitates the encoding of the full 128 ASCII character set. Code 128 is one of the most 
compact linear bar code symbologies. Character set C enables numeric data to be represented 
in a double density mode. In this mode, two digits are represented by only one symbol 
character saving valuable space. The code is concatenated. That means that multiple Als and 
their fields may be combined into a single bar code. The code is also very reliable. Code 128 
symbols use two independent self-checking features which improves printing and scanning 
reliability. 


UCC/EAN-128 bar codes always contain a special non-data character known as function 1 
(FNC 1), which follows the start character of the bar code. It enables scanners and processing 
software to auto-discriminate between UCC/EAN-128 and other bar code symbologies, and 
subsequently only process relevant data. 


The UCC/EAN-128 bar code is made up of a leading quiet zone, a Code 128 start character A, 
B, or C, a FNC 1 character, Data (Application Identifier plus data field), a symbol check 
character, a stop character, and a trailing quiet zone. 


UCC/EAN, UCC/128 are a couple of ways you'll hear someone refer to the code. This just 
indicates that the code is structured as dictated by the application identifiers that are used. 


SSCC (Serial Shipping Container Code) formatted following the data structure layout for 
Application Identifier 00. See Table 8, UCC Application Identifier Table on page 57. It could 
be 00 which is the SSCC code. The customer needs to let us know what application identifiers 
are used for their bar code so we can help them. 


There are several ways of writing the code to print the code to Application Identifier '00' 
structure. 
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Using N for the mode (m) parameter 
——p> Example « This example shows with application identifier 00 structure: 
N FOR THE M PARAMETER ZPL Il CODE 
“XA 
“FO90, 200*°BY4 
ABCN, 256,Y,N,Y,N 
“FD>; >80012345123451234512°FS 
“XZ 
66123451234512345128 
* >;>8' sets it to subset C, function | 
¢ '00' is the application identifier followed by '17 characters’, the check digit is selected 
using the "Y' for the (e) parameter to automatically print the 20th character. 
* you are not limited to 19 characters with mode set to N 
Using U for the mode (m) parameter 
——p> Example « The example shows the application identifier 00 format: 
U FOR THE M PARAMETER ZPL Il CODE 
“XA 
“FO90,200 
“BY4°BC,256,Y,N,,U 
“FD0012345123451234512°FS 
“XZ 
66123451234512345126 
UCC Case Mode 


* Choosing U selects UCC Case mode. You will have exactly 19 characters available in 
“ED: 


« Subset C using FNC1 values are automatically selected. 


* Check digit is automatically inserted. 
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Using D for the mode (m) parameter 


——p> Example « This example shows application identifier 00 format ((x.11.x and above): 


D FOR THE M PARAMETER ZPL Il CODE 


“XA 


“FO50,200*BCN,150,¥,N,,D 
AFD (00) 10084423 7449200940*FS 
“XZ 

(00) 1 0084423 7449200941 


(0 at end of field data is a bogus character that is inserted as a place holder for the check digit 
the printer will automatically insert. 


¢ Subset C using FNC1 values are automatically selected. 


¢ Parentheses and spaces can be in the field data. '00' application identifier, followed by 
17 characters, followed by bogus check digit place holder. 


* Check digit is automatically inserted. The printer will automatically calculate the 
check digit and put it into the bar code and interpretation line. 


¢ The interpretation line will also show the parentheses and spaces but will strip them 
out from the actual bar code. 


Printing the Interpretation Line 


==> Example « This example shows printing the interpretation in a different font with firmware 
x.11.x and above: 


INTERPRETATION LINE ZPL Il CODE 
“XA 
“FO50,200 
FD>;>80012345123451234512*FS 
00123451234512345120 


The font command (*AON, 40, 30) can be added and changed to alter the font and size of the 
interpretation line. 


With firmware version older than x.10.x 
« A separate text field needs to be written. 
¢ The interpretation line needs to be turned off. 


« ‘AON, 50,40 is the font and size selection for the separate text field. 
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¢ You have to make sure you enter the correct check digit in the text field. 


¢ Creating a separate text field allows you to format the interpretation line with 
parentheses and spaces. 


FIRMWARE OLDER THAN X.10.X ZPL Il CODE 
“XA 
hFO25,25 
hBCN,150,N,N,Y 
hFD>; >80012345123451234512°FS 
*“FO100,190 
“AON, 50,40 

(00) 1 2345123 451234512 0 hFD(O00) 1 2345123 451234512 O*FS 

AXZ 


Application Identifiers — UCC/EAN APPLICATION IDENTIFIER 


45541L-003 Rev. A 


An Application Identifier is a prefix code used to identify the meaning and the format of the 
data that follows it (data field). 


There are Als for identification, traceability, dates, quantity, measurements, locations, and 
many other types of information. 


For example, the AI for batch number is 10, and the batch number AI is always followed by an 
alphanumeric batch code not to exceed 20-characters. 


The UCC/EAN Application Identifiers provide an open standard that can be used and 
understood by all companies in the trading chain, regardless of the company that originally 
issued the codes. 
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Table 8 * UCC Application Identifier Table 


ZPL Commands 
ABC 


Plus The Following Data 


Data Content Al Biructura 
Serial Shipping Container Code (SSCC) 00 exactly 18 digits 
Shipping Container Code 01 exactly 14 digits 
Batch Numbers 10 up to 20 alpha numerics 
Production Date (YYMMDD) 11 exactly 6 digits 
Packaging Date (YYMMDD) 13 exactly 6 digits 
Sell By Date (YYMMDD) 15 exactly 6 digits 
Expiration Date (YYMMDD) 17 exactly 6 digits 
Product Variant 20 exactly 2 digits 
Serial Number 21 up to 20 alpha numerics 
HIBCC Quantity, Date, Batch and Link 22 up to 29 alpha numerics 
Lot Number 23* | up to 19 alpha numerics 
Quantity Each 30 
Net Weight (Kilograms) 310** | exactly 6 digits 
Length, Meters 311** | exactly 6 digits 
Width or Diameter (Meters) 312** | exactly 6 digits 
Depths (Meters) 313** | exactly 6 digits 
Area (Sq. Meters) 314** | exactly 6 digits 
Volume (Liters) 315** | exactly 6 digits 
Volume (Cubic Meters) 316** | exactly 6 digits 
Net Weight (Pounds) 320** | exactly 6 digits 
Customer PO Number 400 | up to 29 alpha numerics 
Ship To (Deliver To) Location Code using 410 | exactly 13 digits 
EAN 13 or DUNS Number with leading 
Zeros 
Bill To (Invoice To) Location Code using 411 | exactly 13 digits 
EAN 13 or DUNS Number with leading 
Zeros 
Purchase from 412 | exactly 13 digits 
Ship To (Deliver To) Postal Code within 420 | up to 9 alpha numerics 
single postal authority 
Ship To (Deliver To) Postal Code with 3- 421 | 3 digits plus up to 9 alpha numerics 
digit ISO Country Code Prefix 
Roll Products - width, length, core diameter, | 8001 | exactly 14 digits 
direction and splices 
Electronic Serial number for cellular mobile | 8002 | up to 20 alpha numerics 


phone 
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Note « Table 8 is a partial table showing the application identifiers. For more current and 
# complete information, search the Internet for UCC Application Identifier. 
For date fields that only need to indicate a year and month, the day field is set to 00. 
* Plus one digit for length indication. 
** Plus one digit for decimal point indication. 
Chaining several application identifiers (firmware x.11.x and later) 
The FNC1, which is invoked by >8, is inserted just before the Al's so that the scanners reading 
the code sees the FNC1 and knows that an AI follows. 
===> Example « This is an example with the mode parameter set to A (automatic): 
“XA 
“BY2,2.5,193 
“FO33,400 
“BCN,,N,N,N,A 
“FD>; >80204017773003486100008535>8910001>837252*°FS 
“FT33,625°AEN,0,0*FD (02) 04017773003486 (10) 0008535 (91) 
0001 (37) 252*°FS 
“XZ, 
—=p Example « This is an example with the mode parameter set to U: 
“XA 
“BY3,2.5,193 
“FO33,200 
“BCN, ,N,N,N,U 


“FD>; >80204017773003486>8100008535>8910001>837252°FS 


“FT33,455°A0N, 30, 30*FD (02) 04017773003486 (10) 0008535 (9 
1) 0001 (37) 252°FS 


“XZ 
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——p»> Example « This is an example with the mode parameter set to D*: 
“XA 
“PON 
“LHO, 0 
SBY 2) 2 Dell 4S 
“FO218, 343 
“BCB, ,Y,N,N,D 
“FD (91) 0005886>8 (10) 0000410549>8 (99) 05*FS 
“XZ 


D* — When trying to print the last Application Identifier with an odd number of characters, 
a problem existed when printing EAN128 bar codes using Mode D. The problem was fixed 
in firmware V60.13.0.6. 
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UPS MaxiCode Bar Code 
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Description The *BD command creates a two-dimensional, optically read (not scanned) 
code. This symbology was developed by UPS (United Parcel Service). 


Notice that there are no additional parameters for this code and it does not generate an 
interpretation line. The “BY command has no effect on the UPS MaxiCode bar code. 
However, the “CV command can be activated. 


Format *BDm,n,t 


This table identifies the parameters for this format: 


Parameters Details 
m = mode Accepted Values: 
2 = structured carrier message: numeric postal code (U.S.) 
3 = structured carrier message: alphanumeric postal code 
(non-U.S.) 
4 = standard symbol, secretary 
5 = full EEC 


6 = reader program, secretary 
Default Value: 2 


n = symbol number | Accepted Values: 1 
Default Value: 1 


to 8 can be added in a structured document 


t = totalnumberof | Accepted Values: 1 
symbols in this sequence 


Default Value: 1 


to 8, representing the total number of symbols 


Example « This is an example of UPS MAXICODE - MODE 2 bar code: 


UPS MAXICODE - MODE 2 ZPL Il CODE 
“XA 
ae ot ee ete we “A FO 5 (0) 5 0) 
, vebchagis ; 
eae aaa nce 
va me afist “BD* FH*FD001840152382802 
nee Sey [)>_1E01 1D961Z00004951_1DUPSN 
eh ee ¢ 1D 06X610 1D159 1D1234567 1D1/1_ 
Lr anee o 1D 1DY 1D634 ALPHA DR 
2 Tt y 3° S33,. 3 
a *3 tht 1DPITTSBURGH_1DPA_1E_04*FS 
bie shiad a cory “ “F030, 300*A0, 30, 30°FDMode2*FS 
“XZ 
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Special Considerations for “FD when Using *BD 


The “FD statement is divided into two parts: a high priority message (hpm) and a low priority 
message (1pm). There are two types of high priority messages. One is for a U.S. Style Postal 
Code; the other is for a non-U.S. Style Postal Code. The syntax for either of these high priority 
messages must be exactly as shown or an error message is generated. 


Format *FD <hpm><lpm> 


This table identifies the parameters for this format: 


Parameters Details 


<hpm> = high Accepted Values: 0 to 9, except where noted 


priority message | U.S. Style Postal Code (Mode 2) 


(applicable only <hpm> = aaabbbcccccdddd 
in Modes 2 and bs . 
3) aaa = three-digit class of service 


bbb = three-digit country zip code 

ccccc = five-digit zip code 
dddd = four-digit zip code extension (if none exists, four 
zeros (0000) must be entered) 
non-U.S. Style Postal Code (Mode 3) 

<hpm> = aaabbbcccccc 

aaa = three-digit class of service 

bbb 
ccccc = six-digit zip code (A through Z or 0 to 9) 


ll 


three-digit country zip code 


<lpm> = low 
priority message 


GS is used to separate fields in a message (0x1D). RS is used to 
separate format types (Ox1E). EOT is the end of transmission 


(only applicable | characters. 

in Modes 2 and Message Header [D>RS 

3) Transportation Data 
Format Header 01GS96 
Tracking Number* <tracking number> 
SCAC* GS<SCAC> 
UPS Shipper Number = GS<shipper number> 
Julian Day of Pickup GS<day of pickup> 
Shipment ID Number = GS<shipment ID number> 
Package n/x GS<n/x> 
Package Weight GS<weight> 
Address Validation GS<validation> 
Ship to Street Address GS<street address> 
Ship to City GS<city> 
Ship to State GS<state> 
RS RS 
End of Message EOT 


(* Mandatory Data for UPS) 
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Comments 


¢ The formatting of <hpm> and <lpm> apply only when using Modes 2 and 3. 
Mode 4, for example, takes whatever data is defined in the *FD command and places it in 
the symbol. 


¢ UPS requires that certain data be present in a defined manner. When formatting MaxiCode 
data for UPS, always use uppercase characters. When filling in the fields in the <lpm> for 
UPS, follow the data size and types specified in Guide to Bar Coding with UPS. 


¢ Ifyou do not choose a mode, the default is Mode 2. If you use non-US. Postal Codes, you 
probably get an error message (invalid character or message too short). When using non- 
U.S. codes, use Mode 3. 


¢ ZPL II doesn’t automatically change your mode based on the zip code format. 


¢ When using special characters, such as GS, RS, or EOT, use the *FH command to tell 
ZPL II to use the hexadecimal value following the underscore character (_ ). 
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“ABE 
EAN-13 Bar Code 


Description The “BE command is similar to the UPC-A bar code. It is widely used 
throughout Europe and Japan in the retail marketplace. 


The EAN-13 bar code has 12 data characters, one more data character than the UPC-A code. 
An EAN-13 symbol contains the same number of bars as the UPC-A, but encodes a 13th digit 
into a parity pattern of the left-hand six digits. This 13th digit, in combination with the 12th 
digit, represents a country code. 


¢ “BE supports fixed print ratios. 


¢ Field data (“FD) is limited to exactly 12 characters. ZPL II automatically truncates or 
pads on the left with zeros to achieve the required number of characters. 


¢ When using JAN-13 (Japanese Article Numbering), a specialized application of EAN-13, 
the first two non-zero digits sent to the printer must be 49. 


Format *BEo,h,f,g 


y 7 Note ¢ Use Interleaved 2 of 5 for UCC and EAN 14. 
Important ¢ If additional information about the EAN-13 bar code is required, go to 
www.aimglobal.org. 


This table identifies the parameters for this format: 


Parameters Details 


° orientation Accepted Values: 
N = normal 


R = rotated 90 degrees (clockwise) 


I = inverted 180 degrees 
B = read from bottom up, 270 degrees 
Default Value: current “FW value 


h = barcode height | Accepted Values: 1 to 32000 


(in dots) Default Value: value set by “BY 
f = print Accepted Values: 

interpretation N = no 

line Y = yes 


Default Value: Y 


g = print Accepted Values: 
interpretation N = no 
line above code Y = yes 


Default Value: N 
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Example « This is an example of an EAN-13 bar code: 


EAN-13 BAR CODE 


ZPL Il CODE 


0°000123°45678 


4 


AXA 
“FO100,100*BY3 
BEN, 100,Y,N 
4FD12345678%°FS 
AXZ 


EAN-13 BAR CODE CHARACTERS 


0 1 2 3 


4 


5 


6 7 8 


Comments The EAN-13 bar code uses the Mod 10 check-digit scheme for error checking. 
For more information on Mod 10, see Mod 10 Check Digit on page 362. 
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Description The *BF command creates a two-dimensional, multi-row, continuous, stacked 
symbology identical to PDF417, except it replaces the 17-module-wide start and stop patterns 
and left/right row indicators with a unique set of 10-module-wide row address patterns. These 
reduce overall symbol width and allow linear scanning at row heights as low as 2X. 


Micro-PDF417 is designed for applications with a need for improved area efficiency but 
without the requirement for PDF417’s maximum data capacity. It can be printed only in 
specific combinations of rows and columns up to a maximum of four data columns by 44 
rows. 


Field data (FD) and field hexadecimal (“FH) are limited to: 
¢ 250 7-bit characters 
¢ 150 8-bit characters 


¢ 366 4-bit numeric characters 


Format *BFo,h,m 


This table identifies the parameters for this format: 


Parameters Details 


oO = orientation Accepted Values: 

N = normal 

R = rotated 90 degrees (clockwise) 
I = inverted 180 degrees 


B = read from bottom up, 270 degrees 
Default Value: current “FW value 


h = barcode height | Accepted Values: 1 to 9999 
(in dots) Default Value: value set by “BY or 10 (Gf no “BY value exists). 


m = mode Accepted Values: 0 to 33 (see Micro-PDF417 Mode on page 67) 
Default Value: 0 (see Micro-PDF417 Mode on page 67) 
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—=p> Example « This is an example of a Micro-PDF417 bar code: 


MICRO-PDF417 BAR CODE 


ZPL Il CODE 


Hen 


“XA 


“FO100,100*BY6 


“BEN, 8,3 


“FDABCDEFGHIJKLMNOPORSTUV“*FS 


“XZ 


To encode data into a Micro-PDF417 Bar Code, complete these steps: 


1. Determine the type of data to be encoded (for example, ASCII characters, numbers, 8-bit 


data, or a combination). 


2. Determine the maximum amount of data to be encoded within the bar code (for example, 
number of ASCII characters, quantity of numbers, or quantity of 8-bit data characters). 


3. Determine the percentage of check digits that are used within the bar code. The higher the 
percentage of check digits that are used, the more resistant the bar code is to damage — 


however, the size of the bar code increases. 


4. Use the chart Micro-PDF417 Mode on page 67 with the information gathered from the 
questions above to select the mode of the bar code. 
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Table 9 *« Micro-PDF417 Mode 


Mode | Number | Number % of Max Max 
(M) of Data | of Data | Cwsfor | Alpha Digits 
Columns| Rows EC Characters 
0 1 11 64 6 8 
1 1 14 50 12 17 
2 1 17 41 18 26 
3 1 20 40 22, 32 
4 1 24 33 30 44 
5 1 28 29 38 55 
6 2, 8 50 14 20 
7 2 11 41 24 35 
8 2 14 32 36 52 
9 2 17 29 46 67 
10 2: 20 28 56 82 
11 ps 23 28 64 93 
12 2 26 29 72 105 
13 3 6 67 10 14 
14 3 8 58 18 26 
15 3 10 53 26 38 
16 3 12 50 34 49 
17 3 15 47 46 67 
18 3 20 43 66 96 
19 3 26 41 90 132 
20 3 32 40 114 167 
21 3 38 39 138 202 
22 3 44 38 162 237 
23 4 6 50 22 32 
24 4 8 44 34 49 
25 4 10 40 46 67 
26 4 12 38 58 85 
2) 4 15 35 76 lll 
28 4 20 33 106 155 
29 4 26 31 142 208 
30 4 32 30 178 261 
31 4 38 29 214 313 
32 4 44 28 250 366 
33 4 4 50 14 20 
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“BI 


Industrial 2 of 


5 Bar Codes 


Description The *BI command is a discrete, self-checking, continuous numeric 


symbology. 


The Industrial 2 of 5 bar code has been in use the longest of the 2 of 5 family of 


bar codes. Of that family, the Standard 2 of 5 (“BJ) and Interleaved 2 of 5 (“B2) bar codes are 


also availab 


With Indust 


le in ZPL II. 


rial 2 of 5, all of the information is contained in the bars. Two bar widths are 


employed in this code, the wide bar measuring three times the width of the narrow bar. 


* “BI supports a print ratio of 2.0:1 to 3.0:1. 
¢ Field data (* FD) is limited to the width (or length, if rotated) of the label. 
Format *BIo,h,f,g 
Important « If additional information about the Industrial 2 of 5 bar code, go to 
www.aimglobal.org. 


This table identifies the parameters for this format: 


Parameters Details 


© = orientation Accepted Values: 


N = normal 
R = rotated 90 degrees (clockwise) 


I = inverted 180 degrees 
B = read from bottom up, 270 degrees 
Default Value: current “FW value 


h = barcode height | Accepted Values: 1 to 32000 


(in dots) Default Value: value set by “BY 
f = print Accepted Values: 
interpretation N = no 
line Y = yes 
Default Value: Y 
g = print Accepted Values: 
interpretation N = no 


line above code 


45541L-003 Rev. A 


Y = yes 
Default Value: N 
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—=p> Example « This is an example of an Industrial 2 of 5 bar code: 


INDUSTRIAL 2 OF 5 BAR CODE ZPL Il CODE 


AXA 
“FO100,100*BY3 
“BIN, 150,Y,N 
4FD123456°FS 
AXZ 

123456 


INDUSTRIAL 2 OF 5 BAR CODE CHARACTERS 


0 1 2 3 4 5 6 7 8 9 
Start/Stop (internal) 
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ZPL Commands 


BJ 


“BJ 


Standard 2 of 5 Bar Code 
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Description The *BJU command is a discrete, self-checking, continuous numeric 
symbology. 


With Standard 2 of 5, all of the information is contained in the bars. Two bar widths are 
employed in this code, the wide bar measuring three times the width of the narrow bar. 


« “BJ supports a print ratio of 2.0:1 to 3.0:1. 
¢ Field data (* FD) is limited to the width (or length, if rotated) of the label. 


Format *BJo,h,f,g 


Important ¢ If additional information about the Standard 2 of 5 bar code is required, go to 
www.aimglobal.org. 


This table identifies the parameters for this format: 


Parameters Details 


© = orientation Accepted Values: 
N = normal 
R = rotated 90 degrees (clockwise) 


I = inverted 180 degrees 
B = read from bottom up, 270 degrees 
Default Value: current “FW value 


h = barcode height | Accepted Values: 1 to 32000 


(in dots) Default Value: value set by “BY 
f£ = print Accepted Values: 

interpretation N = no 

line Y = yes 


Default Value: Y 


g = print Accepted Values: 
interpretation N = no 
line above code Y = yes 


Default Value: N 
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> Example « This is an example of a Standard 2 of 5 bar code: 


STANDARD 2 OF 5 BAR CODE ZPL Il CODE 


AXA 
“FO1L00, 100*BY3 
“BIN, 150,Y,N 
AFD123456°FS 
AXZ 

123456 


STANDARD 2 OF 5 BAR CODE CHARACTERS 


0 1 2 3 4 5 6 7 8 9 
Start/Stop (automatic) 
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ZPL Commands 


‘BK 


“BK 


ANSI Codabar Bar Code 


45541L-003 Rev. A 


Description The ANSI Codabar bar code is used in a variety of information processing 
applications such as libraries, the medical industry, and overnight package delivery companies. 
This bar code is also known as USD-4 code, NW-7, and 2 of 7 code. It was originally 
developed for retail price labeling. 


Each character in this code is composed of seven elements: four bars and three spaces. 
Codabar bar codes use two character sets, numeric and control (start and stop) characters. 


* “BK supports a print ratio of 2.0:1 to 3.0:1. 
¢ Field data (* FD) is limited to the width (or length, if rotated) of the label. 


Format *BKo,e,h,f,9g,k,1 


Important « If additional information about the ANSI Codabar bar code is required, go to 
www.aimglobal.org. 


This table identifies the parameters for this format: 


Parameters Details 


© = orientation Accepted Values: 
N = normal 
R = rotated 90 degrees (clockwise) 


I = inverted 180 degrees 
B = read from bottom up, 270 degrees 
Default Value: current “FW value 


e = check digit Fixed Value: N 
h = barcode height | Accepted Values: 1 to 32000 
(in dots) Default Value: value set by “BY 
f = print Accepted Values: 
interpretation N = no 
line Y = yes 


Default Value: Y 


g = print Accepted Values: 
interpretation N = no 
line above code Y = yes 


Default Value: N 


k = designates a start | Accepted Values: A,B,C, D 
character Default Value: A 


1 = designates stop | Accepted Values: A,B, C, D 
character Default Value: A 


ZPL Il Programming Guide For x.10 through x.13 Firmware 6/9/06 


6/9/06 


ZPL Commands 
“BK 
Example « This is an example of an ANSI Codabar bar code: 
ANSI CODABAR BAR CODE ZPL Il CODE 
“XA 
“FO100,100*BY3 
“BKN,N,150,Y,N,A,A 
“FD123456*FS 
“XZ 
Al23456A 


ANSI CODABAR BAR CODE CHARACTERS 


0 1 2 3 4 5 6 it 8 


Control Characters 


- 2: . $ Ff + 


Start/Stop Characters 
A B C OD 
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ABL 
LOGMARS Bar Code 


Description The *BL command is a special application of Code 39 used by the Department 
of Defense. LOGMARS is an acronym for Logistics Applications of Automated Marking and 


Reading Symbols. 


¢ “BL supports a print ratio of 2.0:1 to 3.0:1. 


¢ Field data (“ FD) is limited to the width (or length, if rotated) of the label. Lowercase 
letters in the “FD string are converted to the supported uppercase LOGMARS 


characters. 


Format *BLo,h,g 


Important ¢ If additional information about the LOGMARS bar code is required, go to 


www.aimglobal.org. 


This table identifies the parameters for this format: 


Parameters 


© = orientation 


Details 


Accepted Values: 
N = normal 
R = rotated 90 degrees (clockwise) 
I = inverted 180 degrees 
B = read from bottom up, 270 degrees 


Default Value: current “FW value 


h = barcode height 


Accepted Values: 1 to 32000 


(in dots) Default Value: value set by “BY 
g = print Accepted Values: 

interpretation N = no 

line above code Y = yes 


Default Value: N 
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—= > Example ¢ This is an example of a LOGMARS bar code: 
LOGMARS BAR CODE ZPL Il CODE 
XA 
“FO100, 75*BY3 
“BLN, 100,N 
“FD1L2AB‘FS 
12AEFO ae 


LOGMARS BAR CODE CHARACTERS 


0 1 2 3 4 5 6 7 8 9 
ABCDEFGHIJKLMNOPQRSTUVWX Y Z 
- . $ / + % 

SPACE 


Comments The LOGMARS bar code produces a mandatory check digit using 
Mod 43 calculations. For further information on the Mod 43 check digit, see 
Mod 43 Check Digit on page 363. 
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ZPL Commands 
ABM 


“ABM 
MSI Bar Code 


Description The *BM command is a pulse-width modulated, continuous, non-self- checking 
symbology. It is a variant of the Plessey bar code (“BP). 


Each character in the MSI bar code is composed of eight elements: four bars and four adjacent 


spaces. 


* “BM supports a print ratio of 2.0:1 to 3.0:1. 


¢ For the bar code to be valid, field data (“F'D) is limited to 1 to 14 digits when 
parameter e is B, C, or D. “FD is limited to | to 13 digits when parameter e is A, plus 


a quiet zone. 


Format *BMo,e,h,f,g,e2 


Important ¢ If additional information about the MSI bar code is required, go to 


www.aimglobal.org. 


This table identifies the parameters for this format: 


Parameters 


© = orientation 


Details 


Accepted Values: 
N = normal 
R = rotated 90 degrees (clockwise) 


I = inverted 180 degrees 
B = read from bottom up, 270 degrees 
Default Value: current *F'W value 


e = check digit 
selection 


Accepted Values: 
A = nocheck digits 
B = 1 Mod 10 
C = 2 Mod 10 


D = | Mod 11 and 1 Mod 10 
Default Value: B 


h = barcode height 


Accepted Values: 1 to 32000 


(in dots) Default Value: value set by “BY 
f£ = print Accepted Values: 

interpretation N = no 

line Y = yes 


Default Value: Y 
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Parameters 
g = print 
interpretation 


line above code 


ZPL Commands 


‘BM 


e2 = inserts check 
digit into the 
interpretation 
line 


Example « This is an example of a MSI bar code: 


Details 
Accepted Values: 
N = no 
Y = yes 
Default Value: N 
Accepted Values: 
N = no 
Y = yes 


Default Value: N 


MSI BAR CODE 


ZPL Il CODE 


123456 


“XA 
“FO100,100*BY3 


“FD123456%FS 
“XZ 


ABMN,B,100,Y,N, 


N 


MSI BAR CODE CHARACTERS 


3 4 5 


6 


7 8 9 
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“BO 


Aztec Bar Code Parameters 
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Description The *BO command creates a two-dimensional matrix symbology made up of 
square modules arranged around a bulls-eye pattern at the center. 


Note « The Aztec bar code works with firmware V60.13.0.11A and higher. 


Format *1 


BOa,b,c,d,e,f,g 


This table identifies the parameters for this format: 


Parameters 


a 


orientation 


magnification 
factor 


Details 


Accepted Values: 
N = normal 
R = rotated 
I = inverted 180 degrees 


B = read from bottom up, 270 degrees 
Default Value: current “FW value 


Accepted Values: 1 to 10 
Default Value: 
1 on 150 dpi printers 
2 on 200 dpi printers 
3 on 300 dpi printers 
6 on 600 dpi printers 


extended channel 
interpretation 
code indicator 


Accepted Values: 

Y = if data contains ECICs 

N =if data does not contain ECICs. 
Default Value: N 


d = error control and | Accepted Values: 
symbol size/type O = default error correction level 
indicator 01 to 99 = error correction percentage (minimum) 
101to104 = 1 to 4-layer compact symbol 
201 to 232 = | to 32-layer full-range symbol 
300 = asimple Aztec “Rune” 
Default Value: 0 
e€ = menu symbol Accepted Values: 


indicator 


Y = if this symbol is to be a menu (bar code reader 


initialization) symbol 
N = if it is not a menu symbol 
Default Value: N 
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Parameters 


£ = number of 
symbols for 
structured 
append 


ZPL Commands | 79 
‘BO 


Details 


Accepted Values: 1 through 26 
Default Value: 1 


g = optional ID field 
for structured 
append 


The ID field is a text string with 24-character maximum 
Default Value: no ID 


Example « This is an example of the *BO command: 


ZPL Il CODE GENERATED LABEL 


“XA 
ABOR,7,N,0,N,1,0 


“FD 7. This is testing label 7*FS 


“XZ 
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“BP 


Plessey Bar Code 
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Description The *BP command is a pulse-width modulated, continuous, non-self- checking 
symbology. 


Each character in the Plessey bar code is composed of eight elements: four bars and four 
adjacent spaces. 


* “BP supports a print ratio of 2.0:1 to 3.0:1. 
¢ Field data (* FD) is limited to the width (or length, if rotated) of the label. 


Format *BPo,e,h,f,g 


Important ¢ If additional information about the Plessey bar code is required, go to 
www.aimglobal.org. 


This table identifies the parameters for this format: 


Parameters Details 


© = orientation Accepted Values: 
N = normal 
R = rotated 90 degrees (clockwise) 


I = inverted 180 degrees 
B = read from bottom up, 270 degrees 
Default Value: current “FW value 


e = print check digit | Accepted Values: 
N = no 
Y = yes 
Default Value: N 


h = barcode height | Accepted Values: 


(in dots) N = no 
Y = yes 
Default Value: N 
f = print Accepted Values: 
interpretation N = no 
line Y = yes 


Default Value: Y 


g = print Accepted Values: 
interpretation N = no 
line above code Y = yes 


Default Value: N 
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—p»> Example « This is an example of a Plessey bar code: 
PLESSEY BAR CODE ZPL Il CODE 
“XA 
“FO100, 100*BY3 
“BPN,N,100,Y,N 
SFD12345“°FS 
12345 AXZ, 


PLESSEY BAR CODE CHARACTERS 


0 1 2 #3 #4 #5 6 #7 8 9 
A B C D —E F 
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‘BQ 


ABO 


ZPL Commands 


QR Code Bar Code 


45541L-003 Rev. A 


Description The *BQ command produces a matrix symbology consisting of an array of 
nominally square modules arranged in an overall square pattern. A unique pattern at three of 
the symbol’s four corners assists in determining bar code size, position, and inclination. 


A wide range of symbol sizes is possible, along with four levels of error correction. User- 
specified module dimensions provide a wide variety of symbol production techniques. 


QR Code Model | is the original specification, while QR Code Model 2 is an enhanced form 
of the symbology. Model 2 provides additional features and can be automatically differentiated 
from Model 1. 


Model 2 is the recommended model and should normally be used. 
This bar code is printed using field data specified in a subsequent “FD string. 


Encodable character sets include numeric data, alphanumeric data, 8-bit byte data, and Kanji 
characters. 


Format *BQa,b,c,d,e 


Important ¢ If additional information about the QR Code bar code is required, go to 
www.aimglobal.org. 


This table identifies the parameters for this format: 


Parameters Details 


a = fieldorientation | Fixed Value: normal (“FW has no effect on rotation) 


b = model Accepted Values: 1 (original) and 2 (enhanced — recommended) 
Default Value: 2 
c = magnification Accepted Values: 1 to 10 
factor Default Value: 


1 on 150 dpi printers 
2 on 200 dpi printers 
3 on 300 dpi printers 


6 on 600 dpi printers 
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Parameters Details 
dad = H,Q,M,L Accepted Values: 
H = ultra-high reliability level 
Q = high reliability level 
M = standard level 
L = high density level 
Default Value: 
Q = if empty 
M = invalid values 
e = N,A,B.K Accepted Values: 1 - 7 
Default Value: 7 


Example « This is an example of a QR Code bar code: 


QR CODE BAR CODE ZPL Il CODE 
[a]: [a] - 
“FO100,100 
= tT “BON, 2,10 
7 A AFDMM, AAC-42°FS 
o " 


On the pages that follow are specific commands for formatting the *BQ command with the 


“FD statements that contain the information to be coded. 
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Considerations for “FD When Using the QR Code: 


QR Switches (formatted into the “FD field data) 


mixed mode <D> 


D = allows mixing of different types of character modes in one code. 
code No. <01 16> 


Value = subtracted from the Nth number of the divided code (must be two digits). 


No. of divisions <02 16> 


Number of divisions (must be two digits). 


parity data <1 byte> 


Parity data value is obtained by calculating at the input data (the original input data before 
divided byte-by-byte through the EX-OR operation). 


error correction level <H, Q, M, L> 


H = ultra-high reliability level 


10 
ll 


high reliability level 
standard level (default) 
L = high density level 


kK 
ll 


character Mode <N, A, B, K> 
N = numeric 


A = alphanumeric 


Bxxxx = 8-bit byte mode. This handles the 8-bit Latin/Kana character set in accordance 
with JIS X 0201 (character values 0x00 to OxFF). 


Xxxx = number of data characters is represented by two bytes of BCD code. 

K = Kanji— handles only Kanji characters in accordance with the Shift JIS system 

based on JIS X 0208. This means that all parameters after the character mode K should be 

16-bit characters. If there are any 8-bit characters (such as ASCII code), an error occurs. 
data character string <Data> 


Follows character mode or it is the last switch in the “FD statement. 


data input <A, M> 


A = Automatic Input (default). Data character string JIS8 unit, Shift JIS. When the input 
mode is Automatic Input, the binary codes of 0x80 to 0Ox9F and OxE0 to OxFF cannot be 
set. 


M = Manual Input 
Two types of data input mode exist: Automatic (A) and Manual (M). If A is specified, the 


character mode does not need to be specified. If M is specified, the character mode must be 
specified. 
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“FD Field Data (Normal Mode) 


Automatic Data Input (A) with Switches 


“FD 


<error correction level>A, 


<data character string> 


“ES 


Example « QR Code, normal mode with automatic data input. 


ZPL Commands 
ABQ 


GENERATED LABEL ZPL Il CODE 
 ] ] “XA 
Ope [m] “FO20,20*°BO,2,10*FDOQA, 0123456789ABCD 2D code*FS 
“XZ 
a 
1 Q = error correction level 
A, = automatic setting 
3 data string character 


Manual Data Input (M) with Switches 


“FD 


<error correction level>M, 


<character mode><data character string> 


SES 


45541L-003 Rev. A 


85 


86 | ZPL Commands 


‘BQ 


45541L-003 Rev. A 


Example * QR Code, normal mode with manual data input: 


GENERATED LABEL ZPL Il CODE 


“XA 
“FO20,20*BO,2,10 
“FDHM, N123456789012345*FS 


ORO RE 
ae 


1 4 
1 H = error correction level (ultra-high reliability level 
2 M, = input mode (manual input) 
3 N = character mode (numeric data) 
4 | data character string 


Example « QR Code, normal mode with standard reliability and manual data input: 


GENERATED LABEL ZPL Il CODE 


AXA 
[m]: [a] F020, 20*BQ, 2, 10*FDMM)A 
t | 


_———— 
Qco49Fs 
| 


M = error correction level (standard-high reliability level 


M, = manual input 
AC-42 = data character string 


B] Ww] ro] 


A = alphanumeric data 
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“FD Field Data (Mixed Mode — requires more switches) 


Automatic Data Input (A) with Switches 
“FD 
<D><code No.> <No. of divisions> <parity data>, 
<error correction level> A, 
<data character string>, 
<data character string>, 
< : >, 
<data character string n**> 
SES 


Manual Data Input (M) with Switches 
“FD 
<code No.> <No. of divisions> <parity data>, 
<error correction level> M, 
<character mode 1> <data character string 1>, 
<character mode 2> <data character string 2>, 


ee Se & Sy, 


<character mode n> <data character string n**> 


SES 


n** up to 200 in mixed mode 
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Example « QR Code, mixed mode with manual data input: 


GENERATED LABEL 


ZPL Il CODE 


“XA 

FO, 20,20*BQ, 2,10 

“FDD03048F, LM, NO123456789, Al2AABB, BOO06qgrcode*FS 
“XZ 


<mixed mode identifier> D (mixed) 

<code No.> M (code number) 
<No. of divisions> D (divisions) 
<parity data> M (Ox8F) 

<error correction level> L (high-density level) 
<input mode> M (manual input) 
<character mode> N (numeric data) 
<data character string> 0123456789 
<character mode> A (alphanumeric data) 
<data character string> 12AABB 
<character mode> B (8-bit byte data) 


0006 (number of bytes) 


<data character string> qrcode 
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——p»> Example « This is an example of QR Code, mixed mode with automatic data input: 
“XA 
“FO20,20*°BO,2,10 
“FDD03048F, LA, 01234567891 2AABBgrcode*FS 
“XZ 


<mixed mode identifier> D (mixed) 

<code No.> M (code number) 

<No. of divisions> D (divisions) 

<parity data> M (Ox8F) 

<error correction level> L (high-density level) 
<input mode> A (automatic input) 

<data character string> 012345678912AABBarcode 
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“BR 
RSS (Reduced Space Symbology) Bar Code 


Description The *BR command is bar code types for space-constrained identification from 
EAN International and the Uniform Code Council, Inc. 


Format *BRa,b,c,d,e,f 


This table identifies the parameters for this format: 


Parameters Details 

a = orientation Accepted Values: 
N = Normal 
R = Rotated 
I = Inverted 


B = Bottom-up 
Default Value: R 


b = symbology type | Accepted Values: 
in the RSS-14 1 = RSS14 
family = RSS14 Truncated 
= RSS14 Stacked 
= RSS14 Stacked Omnidirectional 
= RSS Limited 
RSS Expanded 
= UPC-A 
= UPC-E 
= EAN-13 
= EAN-8 
= UCC/EAN-128 & CC-A/B 
12 = UCC/EAN-128 & CC-C 
Default Value: 1 


faa 
t 


POU ATA oO &BWNDY 
ll 


jd 
t 


c = magnification Accepted Values: 1 to 10 
factor Default Value: 
24 dot = 6, 12 dotis 3, 8 dot and lower is 2 


12 dot = 6, >8 dot is 3, 8 dot and less is 2) 


d = separator height | Accepted Values: 1 or 2 
Default Value: 1 
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ZPL Commands 
ABR 


Details 


e = barcode height | The bar code height only affects the linear portion of the bar code. 


Only UCC/EAN & CC-A/B/C. 
Accepted Values: 1 to 32000 dots 
Default Value: 25 


the segment Accepted Values: 2 to 22, even numbers only, in segments per 


width (RSS line 
expanded only) | Default Value: 22 


Example ¢ This is an example of Symbology Type 7 - UPC-A: 


ZPL Il CODE GENERATED LABEL 


“XA 


*FO10,10°BRN, 7, 5,2, 100 
“FD12345678901|this is composite info%*FS 


“XZ 


LACE Ps Us Stes 


Example ¢ This is an example of Symbology Type 1 - RSS14: 


ZPL Il CODE GENERATED LABEL 


“XA 


“XZ 


“FO10,10*BRN,1,5,2,100 li ‘Th ‘ 7] 
“FD12345678901|this is composite info*FS | 
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UPC/EAN Extensions 
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Description The “BS command is the two-digit and five-digit add-on used primarily by 
publishers to create bar codes for ISBNs (International Standard Book Numbers). These 
extensions are handled as separate bar codes. 


The *BS command is designed to be used with the UPC-A bar code (“BU) and the UPC-E bar 
code (“B9). 


* “BS supports a fixed print ratio. 


¢ Field data (* FD) is limited to exactly two or five characters. ZPL II automatically 
truncates or pads on the left with zeros to achieve the required number of characters. 


Format *BSo,h,f,g 


Important ¢ If additional information about the UPC/EAN bar code is required, go to 
www.aimglobal.org. 


This table identifies the parameters for this format: 


Parameters Details 


© = orientation Accepted Values: 
N = normal 
R = rotated 90 degrees (clockwise) 


I = inverted 180 degrees 
B = read from bottom up, 270 degrees 
Default Value: current “FW value 


h = barcode height | Accepted Values: 1 to 32000 


(in dots) Default Value: value set by “BY 
f = print Accepted Values: 

interpretation N = no 

line Y = yes 


Default Value: Y 


g = print Accepted Values: 
interpretation N = no 
line above code Y = yes 


Default Value: Y 


ZPL Il Programming Guide For x.10 through x.13 Firmware 6/9/06 


6/9/06 


ZPL Commands 
BS 
Example « This is an example of a UPC/EAN Two-digit bar code: 
UPC/EAN 2-DIGIT BAR CODE ZPL Il CODE 
“XA 
“FO100, 100*BY3 
“BSN, 100,Y,N 
“FD12°FS 
“XZ 
le 
UPC/EAN 2-DIGIT BAR CODE CHARACTERS 
0 1 2 3 4 5 6 7 8 9 


Example « This is an example of a UPC/EAN Five-digit bar code: 


UPC/EAN 5-DIGIT BAR CODE ZPL Il CODE 
AXA 
“FO100,100*BY3 
ABSN,100,Y,N 
4FD12345“°FS 
AXZ 
12345 


UPC/EAN 5-DIGIT BAR CODE CHARACTERS 


0 1 2 3 4 =) 6 7 8 9 


Care should be taken in positioning the UPC/EAN extension with respect to the 


UPC-A or UPC-E code to ensure the resulting composite code is within the UPC specification. 
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ABS 
For UPC codes, with a module width of 2 (default), the field origin offsets for the extension 
are: 
—> Example « This is an example of a UPC-A: 
Supplement Origin Adjustment 
X - Offset Y - Offset 
Normal 209 Dots 21 Dots 
Rotated 0 209 Dots 
This is an example of a UPC-E: 
Supplement Origin Adjustment 
X - Offset Y - Offset 
Normal 122 Dots 21 Dots 
Rotated 0 122 Dots 
Additionally, the bar code height for the extension should be 27 dots (0.135 inches) shorter 
than that of the primary code. A primary UPC code height of 183 dots (0.900 inches) requires 
an extension height of 155 dots (0.765 inches). 
——= > Example « This example illustrates how to create a normal UPC-A bar code for the value 


7000002198 with an extension equal to 04414: 


UPC-A BAR CODE WITH EXTENSION ZPL Il CODE 

AXA 
04414 “FO100,100*BY3 
ABUN, 137 
“FD0O7000002198%FS 
“FO400,121 
ABSN,117 
o°°"70000°02198 "5 AFDO44144FS 

AXZ 
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TLC39 bar code 


Description The “BT bar code is the standard for the TCIF can tag telecommunications 
equipment. 


The TCIF CLEI code, which is the Micro-PDF417 bar code, is always four columns. The 
firmware must determine what mode to use based on the number of characters to be encoded. 


Format *BTo,wl,rl,hl,w2,h2 


This table identifies the parameters for this format: 


Parameters Details 

© = orientation Accepted Values: 
N = normal 
R = rotated 
I = inverted 


B = bottom up 
wl = width of the Accepted Value (in dots): 1 to 10 
Code 39 bar Default Value (600 dpi printers): 4 
ne Default Value (200- and 300 dpi printer): 2 


rl = wideto narrow | Accepted Values:2.0to3.0(increments of 0.1) 
bar width ratio — | Default Value: 2 .0 


the Code 39 bar 
code 

hi = height of the Accepted Values (in dots): 1 to 9999 
Code 39 bar Default Value (600 dpi printer): 120 
code 


Default Value (300 dpi printer): 60 
Default Value (200 dpi printer): 40 


h2 = rowheight of | Accepted Values (in dots): 1 to 255 


the Micro- Default Value (600 dpi printer): 8 

PDEoe aor eee Default Value (200- and 300 dpi printers): 4 
w2 = narrow bar Accepted Values (in dots): 1 to 10 

width of the Default Value (600 dpi printer): 4 


Micro-PDF417 


: — es 
bar code Default Value (200- and 300 dpi printers) 
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Example *« TLC39 Bar Code 


This is an example on how to print TLC39 bar code. The callouts identify the key 
components and are followed by a detailed description below: 


Use the command defaults to get results that are in compliance with TCIF industry standards; 
regardless of printhead density. 


1 


“EA°FO1OO, 100*BT*FD123456 (ABCD12345678901234) 
6551212, 888999" FS*XZ 


1 ECI Number. If the seventh character is not a comma, only Code 39 prints. This 
means if more than 6 digits are present, Code 39 prints for the first six digits (and no 
Micro-PDF symbol is printed). 
¢ Must be 6 digits. 
¢ Firmware generates invalid character error if the firmware sees anything but 6 
digits. 
¢ This number is not padded. 


2 Serial number. The serial number can contain up to 25 characters and is variable 
length. The serial number is stored in the Micro-PDF symbol. If a comma follows 
the serial number, then additional data is used below. 


¢ If present, must be alphanumeric (letters and numbers, no punctuation). 
This value is used if a comma follows the ECI number. 
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3 Additional data. If present, it is used for things such as a country code. 
Data cannot exceed 150 bytes. This includes serial number commas. 


e Additional data is stored in the Micro-PDF symbol and appended after the 
serial number. A comma must exist between each maximum of 25 characters in 
the additional fields. 


¢ Additional data fields can contain up to 25 alphanumeric characters per field. 


The result is: 


ZPL Il CODE GENERATED LABEL 
“XA*FO100, a ‘ 
1oo~Br"e0123456, Mee igh at] 
ABCd12345678901234, iF 
Sasa, 

88899 
“EFS°XZ 
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UPC-A Bar Code 


Description The “BU command produces a fixed length, numeric symbology. It is primarily 
used in the retail industry for labeling packages. The UPC-A bar code has 

11 data characters. The 6 dot/mm, 12 dot/mm, and 24 dot/mm printheads produce the UPC-A 
bar code (UPC/EAN symbologies) at 100 percent size. However, an 8 dot/mm printhead 
produces the UPC/EAN symbologies at a magnification factor of 77 percent. 


e 4B 


¢ Fie 


U supports a fixed print ratio. 


Id data (* FD) is limited to exactly 11 characters. ZPL II automatically truncates or 


pads on the left with zeros to achieve required number of characters. 


Format *1 


BUo,h,f,g,e 


www.aimglobal.org. 


Important ¢ If additional information about the UPC-A bar code is required, go to 


This table identifies the parameters for this format: 


Parameters Details 


© = orientation Accepted Values: 


N = normal 
R = rotated 90 degrees (clockwise) 


I = inverted 180 degrees 
B = read from bottom up, 270 degrees 
Default Value: current *F'W value 


h = barcode height | Accepted Values: 1 to 9999 


(in dots) Default Value: value set by “BY 
f = print Accepted Values: 
interpretation N = no 
line Y = yes 
Default Value: Y 
g = print Accepted Values: 
interpretation N = no 


line above code 


Y = yes 
Default Value: N 


e = print check digit | Accepted Values: 
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N = no 
Y = yes 
Default Value: Y 
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The font style of the interpretation line depends on the modulus (width of narrow bar) selected 
in “BY: 


Note ¢ Zero is not allowed. 


* 6dot/mm printer: a modulus of 2 dots or greater prints with an OCR-B interpretation 
line; a modulus of | dot prints font A. 


¢ 8 dot/mm printer: a modulus of 3 dots or greater prints with an OCR-B interpretation 
line; a modulus of 1 or 2 dots prints font A. 


¢ 12 dot/mm printer: a modulus of 5 dots or greater prints with an OCR-B interpretation 
line; a modulus of 1, 2, 3, or 4 dots prints font A. 


¢ 24 dot/mm printer: a modulus of 9 dots or greater prints with an OCR-B interpretation 
line; a modulus of | to 8 dots prints font A. 


—— p> Example « This is an example of a UPC-A bar code with extension: 
UPC-A BAR CODE WITH EXTENSION ZPL Il CODE 
AXA 
04414 “FO100,100*BY3 
“BUN, 137 
“FD07000002198*FS 
“FO400,121 
“BSN, 117 
0°"70000°02198 "5 AFD04414°FS 
“XZ 


Comments The UPC-A bar code uses the Mod 10 check digit scheme for error checking. 
For further information on Mod 10, see Mod 10 Check Digit on page 362. 
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ABX 
Data Matrix Bar Code 


Description The *BX command creates a two-dimensional matrix symbology made up of 
square modules arranged within a perimeter finder pattern. 


The ability to create a rectangular Datamatrix bar code is not available as a ZPL coding option. 


Format *BXo,h,s,c,r,f£,9 


This table identifies the parameters for this format: 


Parameters Details 


© = orientation Accepted Values: 
N = normal 
R = rotated 90 degrees (clockwise) 


I = inverted 180 degrees 
B = read from bottom up, 270 degrees 
Default Value: current “FW value 


h = dimensional Accepted Values: | to the width of the label 
height of The individual elements are square — this parameter specifies 
individual both module and row height. If this parameter is zero (or not 
symbol elements given), the h parameter (bar height) in “BY is used as the 
approximate symbol height. 
s = quality level Accepted Values: 0, 50, 80, 100, 140, 200 


Default Value: 0 


Quality refers to the amount of data that is added to the 
symbol for error correction. The AIM specification refers to it 
as the ECC value. ECC 50, ECC 80, ECC 100, and ECC 140 
use convolution encoding; ECC 200 uses Reed-Solomon 
encoding. For new applications, ECC 200 is recommended. 
ECC 000-140 should be used only in closed applications 
where a single party controls both the production and reading 
of the symbols and is responsible for overall system 
performance. 
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Parameters Details 
c = columns to Accepted Values: 9 to 49 
encode Odd values only for quality 0 to 140 (10 to 144); even values 
only for quality 200. 


Odd values only for quality 0 to 140 (10 to 144); even values 
only for quality 200. The number of rows and columns in the 
symbol is automatically determined. You might want to force 
the number of rows and columns to a larger value to achieve 
uniform symbol size. In the current implementation, quality 0 
to 140 symbols are square, so the larger of the rows or 
columns supplied are used to force a symbol to that size. If 
you attempt to force the data into too small of a symbol, no 
symbol is printed. Ifa value greater than 49 is entered, the 
rows or columns value is set to zero and the size is determined 
normally. If an even value is entered, it generates INVALID-P 
(invalid parameter). If a value less than 9 but not 0, or if the 
data is too large for the forced size, no symbol prints; if “CV 
is active, INVALID-L prints. 


xr = rowstoencode | Accepted Values: 9 to 49 


f£ = formatID(Oto | Accepted Values: 
6) — not used 1 = field data is numeric + space (0..9,”) — No \&” 
with quality set 2 = field data is uppercase alphanumeric + space (A..Z,”) — 

at 200 No \&” 

3 = field data is uppercase alphanumeric + space, period, 
comma, dash, and slash (0..9,A..Z,“.-/”) 

4 = field data is upper-case alphanumeric + space 
(0..9,A..Z,”) — no \&” 

5 = field data is full 128 ASCII 7-bit set 

6 = field data is full 256 ISO 8-bit set 


Default Value: 6 


g = escape sequence | Accepted Values: any character 
control character | Default Value: ~ (tilde) 


This parameter is used only if quality 200 is specified. It is the 
escape character for embedding special control sequences 
within the field data. 
Note ¢ The default value of g will continue to be underscore (_) 
for anyone with firmware versions: V60.13.0.12, V60.13.0.12Z, 
V60.13.0.12B, or V60.13.0.12ZB. 
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Table 10 * Maximum Field Sizes 


ECC 
LEVEL ID=1 ID=2 ID=3 ID=4 ID=5 ID=6 
0 596 452 394 413 310 271 
50 457 333 291 305 228 200 
80 402 293 256 268 201 176 
100 300 218 190 200 150 131 
140 144 105 91 96 72 63 


Maximum Field Sizes 


—— > Example « This is an example of a Data Matrix bar code: 


DATA MATRIX BAR CODE ZPL Il CODE 

“XA 

“FO100,100 

“BXN, 10,200 

“FDZEBRA TECHNOLOGIES CORP 
333 CORPORATE WOODS PKWY 
VERNON HILLS, ILLINOIS 
60061-3109°FS 

“XZ 


Effects of “BY on “BX 
w = module width (no effect) 
xr = ratio (no effect) 


h = height of symbol 


If the dimensions of individual symbol elements are not specified in the *BD command, 
the height of symbol value is divided by the required rows/columns, rounded, limited to a 
minimum value of one, and used as the dimensions of individual symbol elements. 


Field Data (*FD) for “BX 


Quality 000 to 140 


¢ The \& and || can be used to insert carriage returns, line feeds, and the backslash, similar to 
the PDF417. Other characters in the control character range can be inserted only by using 
“FH. Field data is limited to 596 characters for quality 0 to 740. Excess field data causes 
no symbol to print; if “CV is active, INVALID-L prints. The field data must correspond to 
a user-specified format ID or no symbol prints; if “CV is active, INVALID-C prints. 


¢ The maximum field sizes for quality 0 to 140 symbols are shown in the table in the g 
parameter. 
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Quality 200 


If more than 3072 bytes are supplied as field data, it is truncated to 3072 bytes. This limits 
the maximum size of a numeric Data Matrix symbol to less than the 3116 numeric 
characters that the specification would allow. The maximum alphanumeric capacity is 
2335 and the maximum 8-bit byte capacity is 1556. 


If “FH is used, field hexadecimal processing takes place before the escape sequence 
processing described below. 


The underscore is the default escape sequence control character for quality 200 field data. 
A different escape sequence control character can be selected by using parameter g in the 
“BX command. 


The information that follows applies to these versions of firmware: V60.13.0.12, 
V60.13.0.12Z, V60.13.0.12B, or V60.13.0.12ZB. The input string escape sequences can be 
embedded in quality 200 field data using the ASCII 95 underscore character (__ ) or the 
character entered in parameter g: 


_X is the shift character for control characters (e.g., @=NUL, G=BEL, 0 is PAD) 
_1to 3 for FNC characters 1 to 3 (explicit FNC4, upper shift, is not allowed) 


FNC2 (Structured Append) must be followed by nine digits, composed of three-digit 
numbers with values between | and 254, that represent the symbol sequence and file 
identifier (for example, symbol 3 of 7 with file ID 1001 is represented by 

_ 2214001001) 


S5NNN is code page NNN where NNN is a three-digit code page value (for example, Code 
Page 9 is represented by 5009) 


__dNNN creates ASCII decimal value NNN for a code word (must be three digits) 


_ in data is encoded by __ (two underscores) 


The information that follows applies to all other versions of firmware. The input string escape 
sequences can be embedded in quality 200 field data using the ASCII 7E tilde character (~) or 
the character entered in parameter g: 


~X is the shift character for control characters (e.g., ~@=NUL, ~G=BEL,~0 is PAD) 


~1 to ~3 for FNC characters | to 3 (explicit FNC4, upper shift, is not allowed) 


FNC2 (Structured Append) must be followed by nine digits, composed of three-digit 
numbers with values between | and 254, that represent the symbol sequence and file 
identifier (for example, symbol 3 of 7 with file ID 1001 is represented by 
~2214001001) 


S5NNN is code page NNN where NNN is a three-digit code page value (for example, Code 
Page 9 is represented by ~5009) 


~dNNN creates ASCII decimal value NNN for a code word (must be three digits) 


~ in data is encoded by a ~ (tilde) 


ZPL Il Programming Guide For x.10 through x.13 Firmware 6/9/06 


ZPL Commands | 103 
ABY 


ABY 
Bar Code Field Default 


Description The “BY command is used to change the default values for the module width 
(in dots), the wide bar to narrow bar width ratio and the bar code height (in dots). It can be 
used as often as necessary within a label format. 


Format *BYw,r,h 


This table identifies the parameters for this format: 


Parameters Details 


w = module width (in | Accepted Values: 1 to 10 


dots) Initial Value at power-up: 2 

x = wide bar to Accepted Values: 2.0 to 3.0, in 0.1 increments 
secuaad bar width This parameter has no effect on fixed-ratio bar codes. 
rane Default Value: 3 .0 


h = barcode height | Initial Value at power-up: 10 
(in dots) 


For parameter r, the actual ratio generated is a function of the number of dots in parameter w, 
module width. See Table 11 on page 104. 


==» Example ¢ Set module width (w) to 9 and the ratio (r) to 2.4. The width of the narrow bar is 
9 dots wide and the wide bar is 9 by 2.4, or 21.6 dots. However, since the printer rounds out 
to the nearest dot, the wide bar is actually printed at 22 dots. 


This produces a bar code with a ratio of 2.44 (22 divided by 9). This ratio is as close to 2.4 as 
possible, since only full dots are printed. 
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Module width and height (w and h) can be changed at anytime with the “BY command, 
regardless of the symbology selected. 


Table 11 * Shows module width ratios in dots 


Ratio 
Selected Module Width in Dots (w) 


(r) 


Comments Once a “BY command is entered into a label format, it stays in effect until 
another “BY command is encountered. 
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ABZ 
POSTNET Bar Code 


Description The POSTNET bar code is used to automate the handling of mail. POSTNET 
uses a Series of five bars, two tall and three short, to represent the digits 0 to 9. 


* “BZ supports a print ratio of 2.0:1 to 3.0:1. 
¢ Field data (* FD) is limited to the width (or length, if rotated) of the label. 


Format *BZo,h,f,g 


Important ¢ If additional information about the POSTNET bar code is required, go to 

www.aimglobal.org, or contact the United States Postal Service and ask for Publication 25 — 
Designing Letter Mail, which includes a full specification for POSTNET. You can also 
download Publication 25 from: 


http://pe.usps.gov/cpim/ftp/pubs/pub25/pub25.pdf 


This table identifies the parameters for this format: 


Parameters Details 


© = orientation Accepted Values: 
N = normal 
R = rotated 90 degrees (clockwise) 


I = inverted 180 degrees 
B = read from bottom up, 270 degrees 
Default Value: current “FW value 


h = barcode height | Accepted Values: 1 to 32000 


(in dots) Default Value: value set by “BY 
f = print Accepted Values: 

interpretation N = no 

line Y = yes 


Default Value: N 


g = print Accepted Values: 
interpretation N = no 
line above code Y = yes 


Default Value: N 
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Example « This is an example of a POSTNET bar code: 


POSTNET BAR CODE 


ZPL Il CODE 


lululdallilillill 
12345 


AXA 
“FO100,100*BY3 
ABZN,40,Y,N 
AFD12345°FS 
AXZ 


POSTNET BAR CODE CHARACTERS 


0 1 2 3 


4 


5 6 7 8 
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Description The “CC command is used to change the format command prefix. The default 
prefix is the caret (*). 


Format *CCx or ~CCx 


This table identifies the parameters for this format: 


Parameters Details 


x = caret character 
change 


Accepted Values: any ASCII character 


Default Value: a parameter is required. If a parameter is not 
entered, the next character received is the new prefix character. 


Example ¢ This is an example of how to change the format prefix to / from a :: 
“XA 
MOST 
/XZ 


The forward slash (/) is set at the new prefix. Note the /XZ ending tag uses the new 
designated prefix character (/). 


Example « This is an example of how to change the format prefix from ~ toa /: 
~CC/ 
/XA/JUS/XZ 
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Descrip 
character 


tion The “CD and ~CD commands are used to change the delimiter character. This 
is used to separate parameter values associated with several ZPL II commands. The 


default delimiter is a comma (,). 


Format 


“CDa or ~CDa 


This table identifies the parameters for this format: 


Parameters 


a = delimiter 
character change 


Details 


Accepted Values: any ASCII character 
Default Value: a parameter is required. If a parameter is not 
entered, the next character received is the new prefix character. 


Example « This shows how to change the character delimiter to a semi-colon (; ) : 
“XA 
“FO10,10 
“GB10,10,3 
“XZ 


“XA 


SE 


D; 


“FO10;10 


“Gl 


B10;10;3 


“XZ 


¢ To 


save, the JUS command is required. Here is an example using JUS: 


~CD; 
“XA* JUS*XZ 
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Description The *CF command sets the default font used in your printer. You can use the 
“CF command to simplify your programs. 


Format *CFf,h,w 


This table identifies the parameters for this format: 


Parameters Details 
f£ = specified default | Accepted Values: A through Z and 0 to 9 
font Initial Value at power-up: A 
h = individual Accepted Values: 0 to 32000 
character height | [nitial Value at power-up: 9 
(in dots) 
w = individual Accepted Values: 0 to 32000 
character width | Jnitial Value at power-up: 5 or last permanent saved value 
(in dots) 


Parameter f specifies the default font for every alphanumeric field. Parameter h is the default 
height for every alphanumeric field, and parameter w is the default width value for every 
alphanumeric field. 


The default alphanumeric font is A. If you do not change the alphanumeric default font and do 
not use any alphanumeric field command (“*AF) or enter an invalid font value, any data you 
specify prints in font A. 


Defining only the height or width forces the magnification to be proportional to the parameter 
defined. If neither value is defined, the last “CF values given or the default “CF values for 
height and width are used. 


Example « This is an example of “CF code and the result of the code: 


ZPL Il CODE GENERATED LABEL 


Hee A GUIDE TO 


“CEO4 89 


“F020, 50 THE ZPL Il 


“FDA GUIDE TO*FS 


eee PROGRAMMING 
“FDTHE ZPL II*FS 

Serer LANGUAGE 
“FDPROGRAMMING* FS 
“FO20, 350 


“FDLANGUAGE* FS 
“XZ 
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Comments Any font in the printer, including downloaded fonts, EPROM stored fonts, and 
fonts A through Z and 0 to 9, can also be selected with *CW. 
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glee 3 
Change International Font/Encoding 


Description Zebra printers can print fonts using international character sets: U.S.A.1, 
U.S.A.2, UK, Holland, Denmark/Norway, Sweden/Finland, Germany, France |, France 2, 
Italy, Spain, and several other sets.. 


The “CI command enables you to call up the international character set you want to use for 
printing. You can mix character sets on a label. 


This command allows character remapping. Any character within a font can be remapped to a 
different numerical position. 


Format *CIa,sl1,dl,s2,d2,... 
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This table identifies the parameters for this format: 


Parameters Details 


a = desired character | Accepted values 0 - 12 are Zebra Code Page 850 with specific 
set character replacements. For details, see International Character 
Sets on page 114 and/or Zebra Code Page 850 on page 340. 
Accepted Values: 
0 = Single Byte Encoding - U.S.A. 1 Character Set 
= Single Byte Encoding - U.S.A. 2 Character Set 
= Single Byte Encoding - U.K. Character Set 
= Single Byte Encoding - Holland Character Set 
= Single Byte Encoding - Denmark/Norway Character Set 
Single Byte Encoding - Sweden/Finland Character Set 
= Single Byte Encoding - Germany Character Set 
= Single Byte Encoding - France 1 Character Set 
= Single Byte Encoding - France 2 Character Set 


OMAN DO BR WN EP 
ll 


= Single Byte Encoding - Italy Character Set 


10 = Single Byte Encoding - Spain Character Set 


hb 
bh 
Il 


Single Byte Encoding - Miscellaneous Character Set 


Single Byte Encoding - Japan (ASCII with Yen 
symbol) Character Set 


3 = Zebra Code Page 850 (see page 340) 
4 = Double Byte Asian Encodings * 
15 = Shift-JIS ** 
6 = EUC-JP and EUC-CN * 
17 = Deprecated - UCS-2 Big Endian **** 
18 to 23 = Reserved 
24 = Single Byte Asian Encodings * 
25 = Reserved 


26 = Multibyte Asian Encodings with ASCII Transparency 
* and oR 


27 = Zebra Code Page 1252 (see page 342) 
Initial Value at power-up: 0 


hb 
i) 
Il 


sl = source | Accepted Values: decimals 0 to 255 
(character output 
image) 


dil = destination | Accepted Values: decimals 0 to 255 
(character input) 


S2 = source 2 Accepted Values: decimals 0 to 255 
(character output 
image) 
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Parameters Details 


d2 = destination 2 Accepted Values: decimals 0 to 255 
(character input) 


. = continuation of — | Up to 256 source and destination pairs can be entered in this 
pattern command. 


* The encoding is controlled by the conversion table (* . DAT). The table generated by 
ZTools™ is the TrueType fonts internal encoding (Unicode). 


** Shift-JIS encoding converts Shift-JIS to JIS and then looks up the JIS conversion in 
JIS .DAT. This table must be present for Shift-JIS to function. 


*** Supports ASCII transparency for Asian . 7F and less are treated as single byte characters. 
80 to FE is treated as the first byte of a 2 byte character 8000 to FEFF in the encoding table for 


Unicode. 


Example « This example remaps the Euro symbol (36) decimal to the dollar sign value (21) 
decimal. When the dollar sign character is sent to the printer, the Euro symbol prints. 


‘CLO, 36,21 


The font selected determines the shape and resolution of the printed symbol. 
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International Character Sets 


--ae-- ON 
m —~J 


aoa a a on WOOD 
cs 


Cl4 
clés 
CI6 
Cl? 
Cle 
clg 
CL10 
CI11 
Chiz 
Chis 


HHH PH HEH HOCH H TH Wh 
aC Or + -@ 


IDMNMOoWVWoaVooaoowWoV WAH 
Q @QMhmom ye WOM ewad eo Wf 
aoa oe ETA eee OO 
Oe OO OO A A OO 
mas Oe ee ee 
> PP DP PO > Pop > > > > TO 
a af: 


aves DSO DO Oo BR See O!)6 6K.) 


-----= MOC --a Oo 8 
2 2@O 27 O Pwo ef 2 2 2 


we ee Oe De De oe Co Be Wo We We Deke OT 


Notes *CI 13 = US keyboard 


Comments The space character cannot be remapped for any font. 
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Description The “CM command allows you to reassign a letter designation to the printer’s 
memory devices. If a format already exists, you can reassign the memory device to the 
corresponding letter without forcing, altering, or recreating the format itself. 


Using this command affects every subsequent command that refers to specific memory 
locations. 


Format *CMa,b,c,d 


This table identifies the parameters for this format: 


Parameters Details 

a = memory alias for | Accepted Values: B:,E:,R:,A:,and NONE 
B: Default Value: B: 

b = memory alias for | Accepted Values: B:,E:,R:,A:,and NONE 
E: Default Value: E: 

c = memory alias for | Accepted Values: B:,E:,R:,A:,and NONE 
R: Default Value: R: 

d = memory alias for | Accepted Values: B:,E:,R:,A:,and NONE 
A: Default Value: A: 


Comments If two or more parameters specify the same letter designator, all letter 
designators are set to their default values. 


It is recommended that after entering the “CM command, “JUS is entered to save changes to 
EEPROM. Any duplicate parameters entered reset the letter designations back to the default. 


If any of the parameters are out of specification, the command is ignored. 


Example « This example designates letter E: to point to the B: memory device, and the 
letter B: to point to the E: memory device. 


“XA 


ACME,B,R,A 
“JUS 
AXA 
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Cache On 
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Note « If you have firmware x.12 or greater this command is not required because the printer 
firmware automatically expands the size of the character cache as needed. 


Description The *CO command is used to change the size of the character cache. By 
definition, a character cache (referred to as cache) is a portion of the DRAM reserved for 
storing scalable characters. All printers have a default 40K cache that is always turned on. The 
maximum single character size that can be stored, without changing the size of the cache, is 
450 dots by 450 dots. 


There are two types of fonts used in Zebra printers: bitmapped and scalable. Letters, numbers, 
and symbols in a bitmapped font have a fixed size (for example: 10 points, 12 points, 14 
points). By comparison, scalable fonts are not fixed in size. 


Because their size is fixed, bitmapped fonts can be moved quickly to the label. In contrast, 
scalable fonts are much slower because each character is built on an as-needed basis before it 
is moved to the label. By storing scaled characters in a cache, they can be recalled at a much 
faster speed. 


The number of characters that can be stored in the cache depends on two factors: the size of the 
cache (memory) and the size of the character (in points) being saved. The larger the point size, 
the more space in the cache it uses. The default cache stores every scalable character that is 
requested for use on a label. If the same character, with the same rotation and size is used 
again, it is quickly retrieved from cache. 


It is possible that after a while the print cache could become full. Once the cache is full, space 
for new characters is obtained by eliminating an existing character from the print cache. 
Existing characters are eliminated by determining how often they have been used. This is done 
automatically. For example, a 28-point Q that was used only once would be a good candidate 
for elimination from the cache. 


Maximum size of a single print cache character is 1500 dots by 1500 dots. This would require 
a cache of 274K. 


When the cache is too small for the desired style, smaller characters might appear but larger 
characters do not. If possible, increase the size of the cache. 


Format *COa,b,c 
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This table identifies the parameters for this format: 


Parameters Details 
a = cache on Accepted Values: 
N = no 
Y = yes 
Default Value: Y 
b = amount of Accepted Values: any size up to total memory available 
additional Default Value: 40 


memory to be 
added to cache 
(in K) 


c = cache type Accepted Values: 

0 = cache buffer (normal fonts) 

1 = internal buffer (recommended for Asian fonts) 
Default Value: 0 


Example « To resize the print cache to 62K, assuming a 22K existing cache: 
“COY, 40 


To resize the print cache to 100K, assuming a 22K existing cache: 
“COoY,78 


Print Cache Performance 


For printing large characters, memory added to the cache by the *CO command is not 
physically added to the 22K cache already in the printer. In the second example above, the 
resulting 100K cache is actually two separate blocks of memory, 22K and 78K. 


Because large characters need contiguous blocks of memory, a character requiring a cache of 
90K would not be completely stored because neither portion of the 100K cache is big enough. 
Therefore, if large characters are needed, the “CO command should reflect the actual size of 
the cache you need. 


Increasing the size of the cache improves the performance in printing scalable fonts. However, 
the performance decreases if the size of the cache becomes large and contains too many 
characters. The performance gained is lost because of the time involved searching cache for 
each character. 


Comments The cache can be resized as often as needed. Any characters in the cache when it 
is resized are lost. Memory used for the cache reduces the space available for label bitmaps, 
graphic, downloaded fonts, et cetera. 


Some Asian fonts require an internal working buffer that is much larger than the normal cache. 
Since most fonts do not require this larger buffer, it is now a selectable configuration option. 
Printing with the Asian fonts greatly reduces the printer memory available for labels, graphics, 
fonts, and formats. 
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“CT ~CT 
Change Tilde 


Description The “CT and ~CT commands are used to change the control command prefix. 
The default prefix is the tilde (~). 


Format *CTa or ~CTa 


This table identifies the parameters for this format: 


Parameters Details 


a = change control Accepted Values: any ASCII character 


command Default Value: a parameter is required. If a parameter is not 
character entered, the next character received is the new control command 
character. 
=> Example « This is an example of how to change the control command prefix from a “ toa ~: 

“XA 

CT 

“XZ 

+HS 
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“Cv 
Code Validation 


Description The *CV command acts as a switch to turn the code validation function on and 
off. When this command is turned on, all bar code data is checked for these error conditions: 


* character not in character set 

* check-digit incorrect 

¢ data field too long (too many characters) 
¢ data field too short (too few characters) 


* parameter string contains incorrect data or missing parameter 


When invalid data is detected, an error message and code is printed in reverse image in place 
of the bar code. The message reads INVALID - X where X is one of these error codes: 


C = character not in character set 

E = check-digit incorrect 

L = data field too long 

S = data field too short 

P = parameter string contains incorrect data 


(occurs only on select bar codes) 


Once turned on, the “CV command remains active from format to format until turned off by 
another “CV command or the printer is turned off. The command is not permanently saved. 


Format *CVa 


This table identifies the parameters for this format: 


Parameters Details 


a = code validation | Accepted Values: 
N = no 
Y = yes 
Default Value: N 
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Comments If more than one error exists, the first error detected is the one displayed. 


ZPL Il CODE GENERATED LABEL 
“XA 
“FO50,50 


“BEN, 100,Y,N 
“FD97823456 890°FS 
“XZ 


AXA 

ACVY 

“FO50;50 

“BEN, 100,Y,N 
“FD9782345678907°FS 
AXZ 


INVALID - E 


AXA 

ACVY 

“POS 0.5.0 

“BEN, 100,Y,N 
“FD97823456789081°FS 
ANZ, 


INVALID - L 


“XA 

“CVY 

“FO50,50 

“BEN, 100,Y,N 
“FD97823456789*FS 
“XZ 


INVALID - S$ 


“XA 

“CVY 

“FO50,50 

“BON2, 3 

“FDHM, BORCODE-22“°FS 
“XZ 


INVALID — P 


Example « The examples below show the error labels “CVY generates when incorrect field 
data is entered. Compare the letter following JVVALID — to the listing on the previous page. 


The “CV command tests the integrity of the data encoded into the bar code. It is not used for 
(or to be confused with) testing the scan-integrity of an image or bar code. 
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“ACW 
Font Identifier 


Description All built-in fonts are referenced using a one-character identifier. The *CW 
command assigns a single alphanumeric character to a font stored in DRAM, memory card, 
EPROM, or Flash. 


If the assigned character is the same as that of a built-in font, the downloaded font is used in 
place of the built-in font. The new font is printed on the label wherever the format calls for the 
built-in font. If used in place of a built-in font, the change is in effect only until power is turned 
off. 


If the assigned character is different, the downloaded font is used as an additional font. The 
assignment remains in effect until a new command is issued or the printer is turned off. 


Format *CWa,d:o.x 


This table identifies the parameters for this format: 


Parameters Details 


a = letter of existing | Accepted Values: A through Z and 0 to 9 
font to be Default Value: a one-character entry is required 
substituted, or 
new font to be 
added 


d = device to store Accepted Values: R:,E:,B:,and A: 
font in (optional) | Default Value: R: 


o = name of the Accepted Values: any name up to 8 characters 
downloaded font | Default Value: if a name is not specified, UNKNOWN is used 
to be substituted 
for the built-in, 
or as an 
additional font 


x = extension Accepted Values: 
.FNT = Font 
.TTE = TrueType Font 
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—p> Example « These examples show how to use: 

* MYFONT.FNT stored in DRAM whenever a format calls for Font A: 
“XA 
“CWA, R:MYFONT.FNT 
“XZ 

¢ MYFONT.FNT stored in DRAM additionally as Font Q: 
“XA 
“CWO, R:MYFONT.FNT 
“XZ 

* NEWFONT.FNT stored in DRAM whenever a format calls for font F: 
“XA 
“CWF, R:NEWFONT. FNT 
“XZ 


DIRECTORY OF R=*.%* 
F  R?NEWFONT.FNT 65268 


DIRECTORY OF R=*.% 


R?NEWFONT.FNT 65268 
AQ R:MYFONT.FNT 65268 


982164 BYTES FREE R-= 


Label Listing Before Assignment Label Listing After Assignment 


R?MYFONT.FNT 65268 


982164 BYTES FREE R= 
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Description The ~DB command sets the printer to receive a downloaded bitmap font and 
defines native cell size, baseline, space size, and copyright. 


This command consists of two portions, a ZPL II command defining the font and a structured 
data segment that defines each character of the font. 


Format ~DBd:o.x,a,h,w,base, space, #char,©,data 


This table identifies the parameters for this format: 


Parameters 


d = drive to store 
font 


o = name of font 


Details 


Accepted Values: R:,E:,B:,and A: 
Default Value: R: 


Accepted Values: | to 8 alphanumeric characters 
Default Value: if a name is not specified, UNKNOWN is used 


x = extension 


Fixed Value: . FNT 


a = orientation of 
native font 


Fixed Value: normal 


h = maximum height 
of cell (in dots) 


Accepted Values: 0 to 32000 
Default Value: a value must be specified 


Ww = maximum width 
of cell (in dots) 


Accepted Values: 0 to 32000 
Default Value: a value must be specified 


base = dots from 
top of cell to 
character 
baseline 


Accepted Values: 0 to 32000 
Default Value: a value must be specified 


space = width of 
space or 
non-existent 
characters 


Accepted Values: 0 to 32000 
Default Value: a value must be specified 


#char = numberof 
characters in font 
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downloaded) 
Default Value: a value must be specified 
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Parameters 


© = copyright holder 


Details 


Accepted Values: 1 to 63 alphanumeric characters 
Default Value: a value must be specified 


data = structured 
ASCII data that 
defines each 
character in the 


The # symbol signifies character code parameters, which are 
separated with periods. The character code is from 1 to 4 
characters to allow for large international character sets to be 
downloaded to the printer. 


font The data structure is: 


#XxXxX.h.w.x.y.i.data 
#xXxXXxX = character code 
h = bitmap height (in dot rows) 
bitmap width (in dot rows) 
x-offset (in dots) 
y-offset (in dots) 
typesetting motion displacement (width, including 


HK Ox & 
ow ol 


inter character gap of a particular character in the font) 


data = hexadecimal bitmap description 


Example « This is an example of how to use the ~DB command. It shows the first two 
characters of a font being downloaded to DRAM. 


~DBR: TIMES. FNT,N,5,24,3,10,2,ZEBRA 1992, 
#0025.5.16.2.5.18. 
OOFF 

OOFF 

FFOO 

FFOO 

FFFF 
#0037.4.24.3.6.26. 
OOFFOO 

OFOOFO 

OFOOFO 

OOFFOO 


r 
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~DE 
Download Encoding 
Description The standard encoding for TrueType Windows® fonts is always Unicode. The 
ZPL II field data must be converted from some other encoding to Unicode that the Zebra 
printer understands. The required translation tables are provided with font packs. Some tables 


can be downloaded from www.zebra.com. 


Format ~DEd:o.x,s,data 


This table identifies the parameters for this format: 


Parameters Details 


d = location of table | Accepted Values: R:,E:,B:,and A: 
Default Value: R: 


o = name of table Accepted Values: any valid name, up to 8 characters 

Default Value: if a name is not specified, UNKNOWN is used 
x = extension Fixed Value: . DAT 
s = table size Accepted Values: the number of memory bytes required to hold 


the Zebra downloadable format of the font 


Default Value: if an incorrect value or no value is entered, the 
command is ignored 


data = datastring | Accepted Values: a string of ASCII hexadecimal values 
Default Value: if no data is entered, the command is ignored 


== Example « This is an example of how to download the required translation table: 


~DER:JIS.DAT, 27848, 300021213001... 


(27848 two-digit hexadecimal values) 


Comments For more information on ZTools or ZebraNet Bridge, see the program 
documentation included with the software. 


For assistance with editing or adding mappings to . DAT tables, ZebraNet Bridge includes a 
. DAT table editor in the font wizard. 


Encoding scheme for the data sent to the printer is the second four character and the encoding 
scheme for the font is the first four characters throughout the . DAT file. The data must be 
ordered by the second four characters (the encoding table). 


6/9/06 ZPL Il Programming Guide For x.10 through x.13 Firmware 45541L-003 Rev. A 


126 


ZPL Commands 


ADF 


“DF 


Download Format 


Example « This example is generated using the “XF command to recall this format: 
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Description The “DF command saves ZPL II format commands as text strings to be later 
merged using “XF with variable data. The format to be stored might contain field number 
(FN) commands to be referenced when recalled. 


While use of stored formats reduces transmission time, no formatting time is saved—this 


command saves ZPL II as text strings formatted at print time. 


Enter the “DF stored format command immediately after the *XA command, then enter the 


format commands to be saved. 


Format *DFd:0.x 


This table identifies the parameters for this format: 


Parameters Details 


d = device to store Accepted Values: R:,E:,B:,and A: 


image Default Value: R: 


Oo = image name Accepted Values: 1 to 


8 alphanumeric characters 


Default Value: 1f a name is not specified, UNKNOWN is used 


x = extension Fixed Value: .ZPL 


For a complete example of the “DF and *XF command, see “DF and “~XF — Download 


format and recall format on page 11. 


ZPL Il CODE 


GENERATED LABEL 


“XA 
“DFR: STOREFMT.ZPL*FS 
“FO25,25 
“AD, 36,20°FN1“*FS 
“FO165,25 
“AD, 36, 20°FN2“°FS 
“FO25,75 
“AB, 22,14°FDBUILT BY*FS 
*PO2Z5, 125 
“AE, 28,15*°FN1 
“XZ 


ZEBRA PRINTER 
BUILT BY 


ZEBRA 


“XA 
“XFR:STOREFMT.ZPL*FS 
“FN1“°FDZEBRA‘*FES 

“XZ 
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~DG 
~DG 
Download Graphics 
Description The ~DG command downloads an ASCII Hex representation of a graphic 
image. If . GRF is not the specified file extension, . GRF is automatically appended. 
For more saving and loading options when downloading files, see ~DY on page 134. 
Format ~DGd:o0.x,t,w,data 
This table identifies the parameters for this format: 
Parameters Details 
d = device to store Accepted Values: R:,E:,B:,and A: 
image Default Value: R: 
Oo = image name Accepted Values: 1 to 8 alphanumeric characters 
Default Value: if a name is not specified, UNKNOWN is used 
x = extension Fixed Value: .GRF 
t = totalnumber of | See the formula in the examples below. 
bytes in graphic 
w = number of bytes | See the formula in the examples below. 
per row 
data = ASCII The data string defines the image and is an ASCII hexadecimal 
hexadecimal representation of the image. Each character represents a horizontal 
string defining nibble of four dots. 
image 


This is the key for the examples that follow: 
x = width of the graphic in millimeters 
= height of the graphic in millimeters 
dots/mm = print density of the printer being programmed 
= bits/byte 


CN XX 
Il 
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=< Examples « These are some example related to the ~DG command: 


To determine the t parameter use this formula: 


x yz = totalbytes 


To determine the correct t parameter for a graphic 8 mm wide, 16 mm high, and a print 
density of 8 dots/mm, use this formula: 


8 x 128 = 1024 
t = 1024 


Raise any portion of a byte to the next whole byte. 


To determine the w parameter (the width in terms of bytes per row) use this formula: 


To determine the correct w parameter for a graphic 8 mm wide and a print density of 8 
dots/mm, use this formula: 


Raise any portion of a byte to the next whole byte. 
Parameter w is the first value in the t calculation. 


The data parameter is a string of hexadecimal numbers sent as a representation of the graphic 
image. Each hexadecimal character represents a horizontal nibble of four dots. For example, 
if the first four dots of the graphic image are white and the next four black, the dot-by-dot 
binary code is 00001111. The hexadecimal representation of this binary value is OF. The 
entire graphic image is coded in this way, and the complete graphic image is sent as one 
continuous string of hexadecimal values. 
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This is an example of using the ~ DG command to load a checkerboard pattern into DRAM. The 
name used to store the graphic is SAMPLE. GRF: 


ZPL Il CODE GENERATED LABEL 
~DGR:SAMPLE.GRF,00080,010, _— | 


PREREEPRPRPRPEPEPERPEREEEEREEEE 
8000FFFFOOOOFFFFOOO1 
8000FFFFOOOOFFFFOOO1 
8000FFFFOOOOFFFFOOO1 
FFFFOOOOFFFFOOQOOFFFE 
FFFFOOOOFFFFOOOOFFFE 
FFFFOOOOFFFFOOOOFFFE 
EFREPEREPE ERR EERERE EP EP. 
“XA 

“F020,20*°XGR: SAMPLE.GRF,1,1*°FS 
“XZ 


Comments Do not use spaces or periods when naming your graphics. Always use different 
names for different graphics. 


If two graphics with the same name are sent to the printer, the first graphic is erased and 
replaced by the second graphic. 
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~DN 
Abort Download Graphic 
Description After decoding and printing the number of bytes in parameter t of the ~DG 
command, the printer returns to normal Print Mode. Graphics Mode can be aborted and normal 
printer operation resumed by using the ~DN command. 
Format ~DN 
Comments If you need to stop a graphic from downloading, you should abort the 


transmission from the host device. To clear the ~DG command, however, you must send a ~DN 
command. 
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~DS 


Download Intellifont (Scalable Font) 


Description The ~DS command is used to set the printer to receive a downloadable scalable 
font and defines the size of the font in bytes. 


The ~DS command, and its associated parameters, is the result of converting a vendor- 
supplied font for use on a Zebra printer. To convert this font use the ZTools utility. 


Format ~DSd:o0.x,s,data 


This table identifies the parameters for this format: 


Parameters Details 


d = device to store Accepted Values: R:,E:,B:,and A: 
image Default Value: R: 


Oo = image name Accepted Values: 1 to 8 alphanumeric characters 
Default Value: 1f a name is not specified, UNKNOWN is used 


x = extension Fixed Value: . FNT 

s = size of font in Fixed Value: this number is generated by ZTools and should not 
bytes be changed 

data = ASCII Fixed Value: this number is generated by ZTools and should not 
hexadecimal be changed 
string that 


defines font 


al Example « This example shows the first three lines of a scalable font that was converted 
using the ZTools program and is ready to be downloaded to the printer. If necessary, the 
destination and object name can be changed. 


~DSB:CGTIMES.FNT, 37080, 
OOFFOOFFOOFFOOFE 
FFOAECB28FFFOOFE 


Comments Downloaded scalable fonts are not checked for integrity. If they are corrupt, they 
cause unpredictable results at the printer. 
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~DT 


Download Bounded TrueType Font 
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Description Use ZTools to convert a TrueType font to a Zebra-downloadable format. 
ZTools creates a downloadable file that includes a ~DT command. For information on 
converting and downloading Intellifont information, see ~DS on page 131. 


Format ~DTd:0.x,s,data 


This table identifies the parameters for this format: 


Parameters Details 


d font location Accepted Values: R:,E:,B:,and A: 


Default Value: R: 


o = font name Accepted Values: any valid TrueType name, up to 8 characters 
Default Value: 1f a name is not specified, UNKNOWN is used 


x = extension Fixed Value: . DAT 


n 
ll 


font size Accepted Values: the number of memory bytes required to hold 
the Zebra-downloadable format of the font 

Default Value: if an incorrect value or no value is entered, the 
command is ignored 


data = datastring | Accepted Values: a string of ASCII hexadecimal values (two 
hexadecimal digits/byte). The total number of two-digit values 
must match parameter s. 


Default Value: if no data is entered, the command is ignored 


Example « This is an example of how to download a true type font: 
~DTR: FONT, 52010,00AFO1BOCE65E... 


(52010 two-digit hexadecimal values) 
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Download Unbounded TrueType Font 


Description Some international fonts, such as Asian fonts, have more than 

256 printable characters. These fonts are supported as large TrueType fonts and are 
downloaded to the printer with the ~DU command. Use ZTools to convert the large TrueType 
fonts to a Zebra-downloadable format. 


The Field Block (*FB) command cannot support the large TrueType fonts. 


Format ~DUd:0.x,s,data 


This table identifies the parameters for this format: 


Parameters 


d = font location 


Details 


Accepted Values: R:,E:,B:,and A: 
Default Value: R: 


o = font name Accepted Values: | to 8 alphanumeric characters 
Default Value: 1f a name is not specified, UNKNOWN is used 
x = extension Fixed Value: . FNT 


s = font size 


Accepted Values: the number of memory bytes required to hold 
the Zebra-downloadable format of the font 


Default Value: 1f no data is entered, the command is ignored 


data = data string 


Accepted Values: a string of ASCII hexadecimal values (two 
hexadecimal digits/byte). The total number of two-digit values 
must match parameter s. 

Default Value: if no data is entered, the command is ignored 


=< Example ¢ This is an example of how to download an unbounded true type font: 
~DUR: KANJI, 86753, 60CA017BOCE7... 


(86753 two-digit hexadecimal values) 


For similar commands, see ~DS on page 131, ~DT on page 132, and ~DY on page 134. 
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Download Graphics / Native TrueType or OpenType Font 
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Description The ~DY command downloads to the printer graphic objects or fonts in any 
supported format. This command can be used in place of ~DG for more saving and loading 
options. ~DY is the preferred command to download TrueType fonts on printers with firmware 
greater than X.13. It is faster than ~ DU. 


Format ~DYd:f,b,x,t,w,data 


This table identifies the parameters for this format: 


Parameters 


d = file location 


Details 


Accepted Values: R:,E:,B:,and A: 
Default Value: R: 


f = file name 


Accepted Values: | to 8 alphanumeric characters 
Default Value: 1f a name is not specified, UNKNOWN is used 


b = format 


Accepted Values: 


downloaded in A = uncompressed (ZB64, ASCII) 
data field B = uncompressed (binary) 
C = AR-compressed (used only by Zebra’s BAR-ONE® v5) 
P = portable network graphic (. PNG) - ZB64 encoded 
Default Value: a value must be specified 
x = extension of Accepted Values: 


stored file 


B = bitmap 


G = raw bitmap (.GRF) 
P = store as compressed (. PNG) 
T = TrueType (.TTF) or X = Paintbrush (.PCX) 


Default Value: a value other than the accepted values defaults to 
.GRF 
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Parameters 


t = total number of 


bytes in file 


ZPL Commands 
~DY 


Details 


Accepted Values: 

. BMP 
This parameter refers to the actual size of the file, not the 
amount of disk space. 

. GRF images: the size after decompression into memory 


This parameter refers to the actual size of the file, not the 
amount of disk space. 

-PCX 
This parameter refers to the actual size of the file, not the 
amount of disk space. 

. PNG images: 
This parameter refers to the actual size of the file, not the 
amount of disk space. 

oli 
This parameter refers to the actual size of the file, not the 
amount of disk space. 


w = total number of | Accepted Values: 
bytes per row . GRF images: number of bytes per row 
. PNG images: value ignored 
. TTF images: value ignored 
data = data ASCH hexadecimal encoding, ZB64, or binary data, depending on 


b. 
ASCII hexadecimal or ZB64 
binary 


A, P 

B, C = 
When binary data is sent, all control prefixes and flow control 
characters are ignored until the total number of bytes needed for 
the graphic format is received. 


Note * The ~DY command and the binary font file can be sent as two separate files. If the files 
are sent to the printer separately, the data light might remain lit until the printer receives the 


TrueType font file. SIZE number of bytes must be received for the download to complete 


successfully. 


Example «¢ This is an example of how to download a binary TrueType Font file of Size bytes 


using the name fontfile.ttf and storing it to permanent flash memory on the printer: 


~DYE: FONTFIL 


-TTF,B,;1T,SlZE,;, 


Comments For more information on ZB64 encoding and compression, see 
ZB64 Encoding and Compression on page 365. 
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~EG 


~EG 


Erase Download Graphics 


See “ID on page 180. 
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“FB 


Field Block 


Description The *F! 


ZPL Commands 
‘FB 


B command allows you to print text into a defined block type format. 


This command formats an “FD or “SN string into a block of text using the origin, font, and 
rotation specified for the text string. The *FB command also contains an automatic word-wrap 
function. 


Format *F) 


Ba,b,c,d,e 


This table identifies the parameters for this format: 


Parameters 


a= 


width of text 
block line (in 
dots) 


Details 


Accepted Values: 0 to the width of the label 
Default Value: 0 


If the value is less than font width or not specified, text does 
not print. 


maximum 
number of lines 
in text block 


add or delete 
space between 
lines (in dots) 


text justification 


Accepted Values: 1 to 9999 
Default Value: 1 


Text exceeding the maximum number of lines overwrites the 
last line. Changing the font size automatically increases or 
decreases the size of the block. 


Accepted Values: -9999 to 9999 
Default Value: 0 
Numbers are considered to be positive unless preceded by a 
minus sign. Positive values add space; negative values delete 
space. 
Accepted Values: 
L = left 
C = center 
R right 
J = justified 
Default Value: L 
If J is used the last line is left-justified. 


6/9/06 


hanging indent 
(in dots) of the 
second and 

remaining lines 


Accepted Values: 0 to 9999 
Default Value: 0 
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ZPL Commands 
FB 


Example « These are examples of how the “FB command affects field data. 


ZPL Il CODE GENERATED LABEL 


i FD command that IS 
XA preceded by an FB 
“CFO, 30, 30*F0O25,50 command. 


“FB250,4,, 

“FDFD command that IS 
preceded by an FB command.*FS 
“XZ 


AXA FD command that IS NOT preceded by an FB cor 
“CEO, 30,,30*FO25, 50 

“FDFD command that IS NOT 
preceded by an FB command.*FS 
AXZ 


Comments on the “FB Command 


This scheme can be used to facilitate special functions: 


\& = carriage return/line feed 
\(*) = soft hyphen (word break with a dash) 
\\ = backslash (\) 


Item 1: “C1I13 must be selected to print a backslash (\). 


Item 2: If a soft hyphen escape sequence is placed near the end of a line, the hyphen is printed. 
If it is not placed near the end of the line, it is ignored. 
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(*) = any alphanumeric character 


If a word is too long to print on one line by itself (and no soft hyphen is specified), a 
hyphen is automatically placed in the word at the right edge of the block. The remainder 
of the word is on the next line. The position of the hyphen depends on word length, not a 
syllable boundary. Use a soft hyphen within a word to control where the hyphenation 
occurs. 


Maximum data-string length is 3K, including control characters, carriage returns, and line 
feeds. 


Normal carriage returns, line feeds, and word spaces at line breaks are discarded. 


When using “FT (Field Typeset), “FT uses the baseline origin of the last possible line of 
text. Increasing the font size causes the text block to increase in size from bottom to top. 
This could cause a label to print past its top margin. 


When using “FO (Field Origin), increasing the font size causes the text block to increase 
in size from top to bottom. 


“FS terminates an “FB command. Each block requires its own “FB command. 
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AFC 
Field Clock (for Real-Time Clock) 


Description The “FC command is used to set the clock-indicators (delimiters) and the clock 
mode for use with the Real-Time Clock hardware. This command must be included within 
each label field command string each time the Real-Time Clock values are required within the 
field. 


Format *FCa,b,c 


This table identifies the parameters for this format: 


Parameters Details 


a = primary clock Accepted Values: any ASCII character 


indicator Default Value: % 
character 


b = secondary clock | Accepted Values: any ASCII character 


indicator Default Value: none—this value cannot be the same as a or c 
character 
c = third clock Accepted Values: any ASCII character 
indicator Default Value: none—this value cannot be the same as a or b 
character 
==> Example « Entering these ZPL commands sets the primary clock indicator to %, the 


secondary clock indicator to {, and the third clock indicator to #. The results are printed on a 
label with Primary, Secondary, and Third as field data. 


ZPL Il CODE GENERATED LABEL 


“XA 


he eae Primary: 00/00/00 


“FDPrimary: %m/%d/%y*FS 
“FO10, 200*A0N, 50,50 
AFCS, {, Secondary: 01/01/00 
“FDSecondary: {m/{d/{y*FS 
“FO10, 300*A0N, 50,50 2 
AEC, {, Third: 01/01/00 
“FDThird: #m/#d/#y*FS 
“XZ 


Comments The *FC command is ignored if the Real-Time Clock hardware is not present. 


For more details on the Real Time Clock, see the Zebra Real Time Clock Guide. 
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“FD 


“FD 


Field Data 
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Description The “FD command defines the data string for the field. The field data can be 
any printable character except those used as command prefixes (* and ~). 


Format *FDa 


This table identifies the parameters for this format: 


Parameters Details 


a = data to be printed | Accepted Values: any data string up to 3072 bytes 
Default Value: none—a string of characters must be entered 


Comments The * and ~ characters can be printed by changing the prefix characters—see 
“CD ~CD on page 108 and “CT ~CT on page 118. The new prefix characters cannot be 
printed. 


Characters with codes above 127, or the “ and ~ characters, can be printed using the “FH and 
“FD commands. 


« *CI13 must be selected to print a backslash (\). 
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ZPL Commands 
AFH 


Field Hexadecimal Indicator 
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Description The *FH command allows you to enter the hexadecimal value for any 
character directly into the “FD statement. The “FH command must precede each “FD 
command that uses hexadecimals in its field. 


Within the “FD statement, the hexadecimal indicator must precede each hexadecimal value. 
The default hexadecimal indicator is _ (underscore). There must be a minimum of two 
characters designated to follow the underscore. The a parameter can be added when a 
different hexadecimal indicator is needed. 


This command can be used with any of the commands that have field data (that is *FD, *FV 
(Field Variable), and “SN (Serialized Data)). 


Valid hexadecimal characters are: 


012345678 9 ABCDEFabcdef 


Format *FHa 


This table identifies the parameters for this format: 


Parameters Details 


a = hexadecimal 
indicator 


Accepted Values: any character except current format and control 
prefix (“ and ~ by default) 


Default Value: _ (underscore) 


Example « This is an example of how to enter a hexadecimal value directly into a “FD 
statement: This is an example for ascii data using *CIO0. 


ZPL Il CODE GENERATED LABEL 


“XA Tilde ~ used for HEX 
“FO100,100 

“AD* FH 

“FDTilde _7e used for HEX*FS 
OX 


“XA 

“FO100,100 Tilde » used for HEX 
v 

“AD* FH\ 

“FDTilde \7E used for HEX*FS 

“XZ, 
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AFM 


“FM 


Multiple Field Origin Locations 


Description The *FM command allows you to control the placement of bar code symbols. 


It designates field locations for the PDF417 (*B7) and Micro-PDF417 (“BF) bar codes when 
the structured append capabilities are used. This allows printing multiple bar codes from the 
same set of text information. 


The structured append capability is a way of extending the text printing capacity of both bar 
codes. If a string extends beyond what the data limitations of the bar code are, it can be printed 


as aseries: | of 3, 2 of 3, 3 of 3. Scanners read the information and reconcile it into the 
original, unsegmented text. 


The “FM command triggers multiple bar code printing on the same label with “B7 and “BF 
only. When used with any other commands, it is ignored. 
Format *FMx1,y1,x2,y2,... 
This table identifies the parameters for this format: 
Parameters Details 
x1 = x-axis location | Accepted Values: 
of first symbol 0 to 32000 
(in dots) e = exclude this bar code from printing 
Default Value: a value must be specified 
yl = y-axis location | Accepted Values: 
of first symbol 0 to 32000 
(in dots) e = exclude this bar code from printing 
Default Value: a value must be specified 
x2 = x-axis location | Accepted Values: 
of second 0 to 32000 
symbol (in dots) e = exclude this bar code from printing 
Default Value: a value must be specified 
y2 = y-axis location | Accepted Values: 
of second 0 to 32000 
symbol (in dots) e = exclude this bar code from printing 
Default Value: a value must be specified 
. = continuation of — | Maximum number of pairs: 60 
X,Y pairs 
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ZPL Commands 
“FM 


Example « This example shows you how to generate three bar codes with the text “Zebra 
Technologies Corporation strives to be...” would need to be repeated seven times, which 
includes 2870 characters of data (including spaces) between “FD and “FS: 


ZPL Il CODE GENERATED LABEL 
“XA 
“FM100,100,100,600,100,1200 
“BY2,3 


“BI7N,5,5,9,83,N 

“FDZebra Technologies 
Corporation strives to be 
the expert supplier of 
innovative solutions to 
specialty demand labeling 
and ticketing problems of 
business and government. 

We will attract and retain 
the best people who will 
understand our customer's 
needs and provide them with 
systems, hardware, software, 
consumables and service 
offering the best value, 
high quality, and reliable 
performance, all delivered 
in a timely manner 


“FS°XZ 


The ellipse is not part of the code. It indicates that the text needs to be 
repeated seven times, as mentioned in the example description. 
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AFM 
——=p> Example « This example assumes a maximum of three bar codes, with bar code 2 of 3 
omitted: 
ZPL Il CODE GENERATED LABEL 
AXA 
“FM100,100,e,e,100,1200 
“BY2,3 


“BIN,5,5,9,83,N 

“FDZebra Technologies 
Corporation strives to be 
the expert supplier of 
innovative solutions to 
specialty demand labeling 
and ticketing problems of 
business and government. 

We will attract and retain 
the best people who will 
understand our customer's 
needs and provide them with 
systems, hardware, software, 
consumables and service 
offering the best value, 
high quality, and reliable 
performance, all delivered 
in a timely manner 


.  <-— 
AFSAXZ 
i 
[nt 
i 
ay 
an 
i te 
fs 
ae 
ee 
ey 
A 
ay, 
a 
{ 1 dba 
1 
1 The ellipse is not part of the code. It indicates that the text needs to be 


repeated seven times, as mentioned in the example description. 


Comments Subsequent bar codes print once the data limitations of the previous bar code 
have been exceeded. For example, bar code 2 of 3 prints once | of 3 has reached the maximum 
amount of data it can hold. Specifying three fields does not ensure that three bar codes print; 
enough field data to fill three bar code fields has to be provided. 


The number of the x, y pairs can exceed the number of bar codes generated. However, if too 
few are designated, no symbols print. 
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Description The *FN command numbers the data fields. This command is used in both 
“DF (Store Format) and “XF (Recall Format) commands. 


In a stored format, use the “FN command where you would normally use the “FD (Field 
Data) command. In recalling the stored format, use “F'N in conjunction with the *FD 
command. 


The number of fields and data that can be stored is dependent in the available printer memory. 


Note * The maximum number of “FN commands that can be used depends on the amount of 
data that is placed in the fields on the label. It is recommended to use 400 or fewer fields. 


Format *FN# 


This table identifies the parameters for this format: 


Parameters Details 


Accepted Values: 0 to 9999 
Default Value: 0 


# = number to be 
assigned to the 
field 


For a complete example of the “DF and *XF command, see “DF and “XF — Download 
format and recall format on page 11. 
Comments 

¢ The same “FN value can be stored with several different fields. 


¢ Ifa label format contains a field with “FN and “FD, the data in that field prints for any 
other field containing the same * F'N value. 


ZPL Il Programming Guide For x.10 through x.13 Firmware 45541L-003 Rev. A 


145 


ZPL Commands 
“FO 


146 


“FO 
Field Origin 


Description The “FO command sets a field origin, relative to the label home (*LH) 
position. “FO sets the upper-left corner of the field area by defining points along the 
x-axis and y-axis independent of the rotation. 


Format *FOx, y 


This table identifies the parameters for this format: 


Parameters Details 


x = x-axis location Accepted Values: 0 to 32000 
(in dots) Default Value: 0 


y-axis location Accepted Values: 0 to 32000 
(in dots) Default Value: 0 


kK 
ll 


Comments If the value entered for the x or y parameter is too high, it could position the 
field origin completely off the label. 
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ZPL Commands 
AFP 


Description The “FP command allows vertical and reverse formatting of the font field, 


commonly used for printing Asian fonts. 


Format *FPd,g 


This table identifies the parameters for this format: 


Parameters Details 


d = direction Accepted Values: 
V 
R 
Default Value: H 


H = horizontal printing (left to right) 
vertical printing (top to bottom) 
reverse printing (right to left) 


g = additional 
inter-character 
gap (in dots) 


Accepted Values: 0 to 9999 


Default Value: 0 if no value is entered 


Example ¢ This is an example of how to implement reverse and vertical print: 


ZPL Il CODE 


GENERATED LABEL 


“XA 

“FO100, 50 
AFPV, 10 

AAV 
“FDvertical*FS 
“XZ, 


—-saottrr oO < 


“XA esrever 
“FO350,50 


“FPR, 10 

“AV 
“FDreverse*FS 
“XZ 
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‘FR 


“FR 


Field Reverse Print 
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Description The *FR command allows a field to appear as white over black or black over 
white. When printing a field and the “FR command has been used, the color of the output is 
the reverse of its background. 


Format *FR 


Example ¢ In this example, the *G! 


appear white: 


B command creates areas of black allowing the printing to 


ZPL Il CODE 


GENERATED LABEL 


“XA 
“PRI 
“FO100,10 


“FO200,10 


“FO300,10 
“GB70,70, 
“FO400,10 
“GB70,70, 
“FO107,11 


0) 


0) 


0 


0 


“GB70; 70,70), 3°FS 
“GB70,; 70,70, ,3°FS 
1074 3°ERS 


107 5.3° 25 
O*CF0, 70,93 


“FR“FDREVE 


(RS 


EES 


“XZ 


REVERSE 


Comments The “FR command applies to only one field and has to be specified each time. 
When multiple “FR commands are going to be used, it might be more convenient to use the 


“LR command. 
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‘FS 


AFS 
Field Separator 


Description The *FS command denotes the end of the field definition. Alternatively, *F'S 
command can also be issued as a single ASCII control code SI (Control-O, hexadecimal OF). 


Format “FS 
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AFT 


Field Typeset 
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Description The “FT command sets the field position, relative to the home position of the 
label designated by the “LH command. The typesetting origin of the field is fixed with respect 
to the contents of the field and does not change with rotation. 


Note ¢ The *FT command is capable of concantination of fields. 


Format *FTx,y 


This table identifies the parameters for this format: 


Parameters 


xX = x-axis location 
(in dots) 


Details 


Accepted Values: 0 to 32000 
Default Value: position after last formatted text field 


y = y-axis location 


Accepted Values: 0 to 32000 


(in dots) Default Value: position after last formatted text field 
Table 12 ¢ Typeset Justification 
Text For examples, see Field Interactions 
= on page 371. 
= Bar Codes Origin is base of bar code, at left edge 
= a Graphic Boxes Origin is bottom-left corner of the box 
Images Origin is bottom-left corner of the image area 
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AFT 


=< Example « This is an example of the *F'T command and concatenation: 


ZPL Il CODE | GENERATED LABEL 


“XA 

“FT10, 200*%AON, 30, 20*FDACMI 

SETSGS* FDC*ES 

“FT*AON, 30,20*%FDSummer “FS 

“FT*AON, 60,50*%FDClearance “FS | Sale 
ACNET"'S 

AFT*AON,120,100*°FDSale “FS ve” some Clearance 

“XZ 


“ES 


GI 


When a coordinate is missing, the position following the last formatted field is assumed. This 
remembering simplifies field positioning with respect to other fields. Once the first field is 
positioned, other fields follow automatically. 


There are several instances where using the “FT command without specifying x and y 
parameters is not recommended: 


¢ when positioning the first field in a label format 

* at any time with the “FN (Field Number) command 
¢ following an “SN (Serialization Data) command 

¢ variable data 


¢ bidirectional text 
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Field Variable 


Description “FV replaces the “FD (field data) command in a label format when the field is 
variable. 


Format *FVa 


This table identifies the parameters for this format: 


Parameters Details 


a = variable field Accepted Values: 0 to 3072 byte string 
data to be printed | Default Value: if no data is entered, the command is ignored 


== Example « This is an example of how to use the “MC and “FV command: 


ZPL Il CODE GENERATED LABEL 


“XA 

“FO40, 40 
“GB300,203,8°FS 

“FO55, 60*CFO,25 
“FVVARIABLE DATA #1°FS 
“FO80,150 

“FDFIXED DATA*FS 

“MCN 

“XZ 


VARIABLE DATA #1 


FIXED DATA 


“XA VARIABLE DATA #2 
“FO55, 60*°CFO0,25 


“FVVARIABLE DATA #2*°FS 
“MCY 
“XZ 


FIXED DATA 


Comments “FV fields are always cleared after the label is printed. “FD fields are not 
cleared. 
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Field Orientation 
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Description The “FW command sets the default orientation for all command fields that have 
an orientation (rotation) parameter. Fields can be rotated 0, 90, 180, or 270 degrees clockwise 
by using this command. 


The “FW command affects only fields that follow it. Once you have issued a “FW command, 
the setting is retained until you turn off the printer or send a new “FW command to the printer. 


Format *FWr 


This table identifies the parameters for this format: 


Parameters 


r = rotate field 


Details 


Accepted Values: 
N = normal 


R = rotated 90 degrees 
I = inverted 180 degrees 
B = bottom-up 270 degrees, read from bottom up 


Initial Value at Power-up: N 


—_— Example « This example shows how “FW rotation works in conjunction with “FO. In this 
example note that: 


* the fields using AON print the field in normal rotation 


¢ the fields with no rotation indicated (AO) follow the rotation used in the “FW command 


(CFWR). 


ZPL Il CODE GENERATED LABEL 


“XA 
“FWR 


Parkway*FS 


AXZ 


*“FO150,100*AON, 70, 60*°FDZebra Technologies*FS 
“FO50,75*A0, 70, 60° FD0123456789*FS 
*“FO150, 200“*AON, 70, 60° FD333 Corporate Woods 


FO900, 75*A0, 70, 60*FDXXXXXXXXX* FS 


= Zebra Technologies 
én 333 Corporate Woods Parkway 


a 


XXXXXXXXX 


682 


Comments “FW affects only the orientation in commands where the rotation parameter has 
not been specifically set. If a command has a specific rotation parameter, that value is used. 
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Comment 
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Description The “FX command is useful when you want to add non-printing informational 
comments or statements within a label format. Any data after the “FX command up to the next 
caret (“) or tilde (~) command does not have any effect on the label format. Therefore, you 

should avoid using the caret (“) or tilde (~) commands within the * FX statement. 


Format *FXc 


This table identifies the parameters for this format: 


Parameters 


c = non printing 
comment 


Details 


Creates a non-printable comment. 


Example ¢ This is an example of how to use the “FX command effectively: 


ZPL Il CODE 


GENERATED LABEL 


“XA 

“LH100,100*°FS 
“FXSHIPPING LABEL*FS 
“FO10,10*GB470,280,4%*FS 
“FO10,190*GB470,4,4°FS 
“FO10, 80*GB240,2,2°FS 
“FO250,10*GB2,100,2*°FS 
“FO250,110*%GB226,2,2°FS 
“FO250, 60*GB226,2,2°FS 
“FO156,190*%GB2,95,2*°FS 
“FO312,190*%GB2,95,2*°FS 
“XZ 


Comments Correct usage of the *FX command includes following it with the *FS 


command. 
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“GB 
Graphic Box 


Description The *GB command is used to draw boxes and lines as part of a label format. 
Boxes and lines are used to highlight important information, divide labels into distinct areas, 
or to improve the appearance of a label. The same format command is used for drawing either 
boxes or lines. 


Format *GBw,h,t,c,r 


This table identifies the parameters for this format: 


Parameters Details 


w = box width (in Accepted Values: value of t to 32000 


dots) Default Value: value used for thickness (t) or 1 
h = box height (in Accepted Values: value of t to 32000 
dots) Default Value: value used for thickness (t) or 1 
t = border thickness | Accepted Values: 1 to 32000 
(in dots) Default Value: 1 
c = line color Accepted Values: 
B = black 
W = white 


Default Value: B 


rv = degree of comer- | Accepted Values: 0 (no rounding) to 8 (heaviest rounding) 
rounding Default Value: 0 


For the w and h parameters, keep in mind that printers have a default of 6, 8, 12, or 
24 dots/millimeter. This comes out to 153, 203, 300, or 600 dots per inch. To determine the 
values for w and h, calculate the dimensions in millimeters and multiply by 6, 8, 12, or 24. 


If the width and height are not specified, you get a solid box with its width and height as 
specified by value t. 


The roundness-index is used to determine a rounding-radius for each box. Formula: 


rounding-radius = (rounding-index / 8) * (shorter side / 2) 


where the shorter side is the lesser of the width and height (after adjusting for minimum and 
default values). 
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Examples « Here are a few examples of graphic boxes: 


Width: 1.5 inch; Height: 1 inch; Thickness: 10; Color: default; Rounding: default 


ZPL Il CODE GENERATED LABEL 
“XA 
“FO50,50 
“GB300,200,10*FS 
“XZ 


Width: 0 inch; Height: 1 inch; Thickness: 20; Color: default; Rounding: default: 


ZPL Il CODE 


GENERATED LABEL 


“XA 

“FO50,50 
“GBO,203,20°FS 
“XZ 


Width: 1 inch; Height: 0 inch; Thickness: 30; Color: default; Rounding: default 


ZPL Il CODE GENERATED LABEL 
“FO50,50 
“GB203,0,20*FS 
“XZ 


Width: 1.5 inch; Height: 1 inch; Thickness: 10; Color: default; Rounding: 5 


ZPL Il CODE GENERATED LABEL 
“XA 
“FO50,50 
“GB300,200,10,,5*FS 
“XZ 
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Graphic Circle 


ZPL Commands 
AGC 


Description The *GC command produces a circle on the printed label. The command 
parameters specify the diameter (width) of the circle, outline thickness, and color. Thickness 
extends inward from the outline. 


Format *GCd,t,c 


This table identifies the parameters for this format: 


Parameters 


d = circle diameter 


Details 


Accepted Values: 3 to 4095 (larger values are replaced with 


(in dots) 4095) 
Default Value: 3 
t = border thickness | Accepted Values: 2 to 4095 
(in dots) Default Value: 1 


c = linecolor 


Accepted Values: 
B = black 
W = white 


Default Value: B 


Example « This is an example of how to create a circle on the printed label: 


ZPL Il CODE GENERATED LABEL 


B“ES C) 


=== 
“XA 
“FO50,50 
“GC250,10,! 
“XZ 
6/9/06 
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“GD 


Graphic Diagonal Line 


Description The “GD command produces a straight diagonal line on a label. This can be 
used in conjunction with other graphic commands to create a more complex figure. 


Format *GDw,h,t,c, 


(2) 


This table identifies the parameters for this format: 


Parameters Details 
w = box width (in Accepted Values: 3 to 32000 
dots) Default Value: value of t (thickness) or 1 
h = box height (in Accepted Values: 3 to 32000 
dots) Default Value: value of t (thickness) or 1 
t = border thickness | Accepted Values: | to 32000 
(in dots) Default Value: 1 
c = line color Accepted Values: 
B = black 
Y = white 
Default Value: B 
Oo = orientation Accepted Values: 
(direction of the R(or/) = right-leaning diagonal 
diagonal) 


—p 


L(or\) = left-leaning diagonal 
Default Value: R 


Example ¢ This is an example of how to create a diagonal line connecting one corner with the 


opposite comer of a box on a printed label: 


ZPL Il CODE 


GENERATED LABEL 


“XA 
“FO150,100 


“GB350,203,10*FS 


“FO155,110 


“GD330,183,10,,R*°FS 


“XZ 


[| 
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“GE 


—pP 
“XA 
“FO100,100 
“XZ 

6/9/06 


Graphic Ellipse 


ZPL Commands | 159 
AGE 


Description The “GE command produces an ellipse in the label format. 


Format *GEw,h,t,c 


This table identifies the parameters for this format: 


Parameters 


w = ellipse width (in 
dots) 


h = ellipse height (in 
dots) 


Details 


Accepted Values: 3 to 4095 (larger values are replaced with 4095) 


Default Value: value used for thickness (t) or 1 


Accepted Values: 3 to 4095 


Default Value: value used for thickness (t) or 1 


t = border thickness 
(in dots) 


c = linecolor 


Accepted Values: 2 to 4095 
Default Value: | 

Accepted Values: 

B = black 


Y = white 
Default Value: B 


Example « This is an example of how to create a ellipse on a printed label: 


ZPL Il CODE 


GENERATED LABEL 


“GE300,100,10,B*FS 


c 
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AGF 
Graphic Field 


Description The *GF command allows you to download graphic field data directly into the 
printer’s bitmap storage area. This command follows the conventions for any other field, 
meaning a field orientation is included. The graphic field data can be placed at any location 
within the bitmap space. 


Format *GFa,b,c,d,data 


This table identifies the parameters for this format: 


Parameters Details 


a = compression type | Accepted Values: 
A = ASCI hexadecimal (follows the format for other 
download commands) 
B = binary (data sent after the c parameter is strictly binary) 
C = compressed binary (data sent after the c parameter is in 
compressed binary format. The data is compressed on 
the host side using Zebra’s compression algorithm. The 
data is then decompressed and placed directly into the 
bitmap.) 
Default Value: A 


b = binary byte count | Accepted Values: 1 to 99999 

This is the total number of bytes to be transmitted for the total 
image or the total number of bytes that follow parameter d. 
For ASCII download, the parameter should match parameter 
c. Out-of-range values are set to the nearest limit. 


Default Value: command is ignored if a value is not specified 


c = graphic field Accepted Values: | to 99999 
count This is the total number of bytes comprising the graphic 
format (width x height), which is sent as parameter d. Count 
divided by bytes per row gives the number of lines in the 
image. This number represents the size of the image, not 
necessarily the size of the data stream (see d). 
Default Value: command is ignored if a value is not specified 
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Parameters Details 


d = bytes per row Accepted Values: | to 99999 
This is the number of bytes in the downloaded data that 
comprise one row of the image. 

Default Value: command is ignored if a value is not specified 


data = data Accepted Values: 
ASCII hexadecimal data: 00 to FF 


A string of ASCII hexadecimal numbers, two digits per image 
byte. CR and LF can be inserted as needed for readability. The 
number of two-digit number pairs must match the above 
count. Any numbers sent after count is satisfied are ignored. 
A comma in the data pads the current line with 00 (white 
space), minimizing the data sent. ~DN or any caret or tilde 
character prematurely aborts the download. 

Binary data: Strictly binary data is sent from the host. All 
control prefixes are ignored until the total number of bytes 
needed for the graphic format is sent. 


—— p> Example ¢« This example downloads 8,000 total bytes of data and places the graphic data at 
location 100,100 of the bitmap. The data sent to the printer is in ASCII form. 


“FO100,100*°GFA, 8000,8000,80,ASCII data 


==> Example « This example downloads 8,000 total bytes of data and places the graphic data at 
location 100,100 of the bitmap. The data sent to the printer is in binary form. 


“FO100,100*GFB, 8000, 8000,80,Binary data 
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ZPL Commands 
AGS 


“GS 
Graphic Symbol 


Description The *GS command enables you to generate the registered trademark, copyright 
symbol, and other symbols. 


Format *GSo,h,w 


This table identifies the parameters for this format: 


Parameters 


o = field orientation 


Details 


Accepted Values: 
N = normal 
R = rotate 90 degrees clockwise 


I = inverted 180 degrees 
B = bottom-up, 270 degrees 
Default Value: N or last “FW value 


h = character height 
proportional to 
width (in dots) 


w = character width 
proportional to 
height (in dots) 


Accepted Values: 0 to 32000 
Default Value: last “CF value 


Accepted Values: 0 to 32000 
Default Value: last “CF value 
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Example « Use the *GS command followed by “FD and the appropriate character (A 
through E) within the field data to generate the desired character: 


ZPL Il CODE GENERATED LABEL 


“XA“*CFD 

“FO50,50 
“FDZEBRA 
“FO50,75 


“FDLANGUAGE II (ZPL II )*FS 


“FO280,75 


“GS*FDC“*FS 


“XZ 


ZEBRA PROGRAMMING 
PROGRAMMING“ FS LANGUAGE II ¢ZPL IIT) 


A =) (Registered Trade Mark) 

B =€) (Copyright) 

c= (Trade Mark) 

D =(4) (Underwriters Laboratories approval) 

E= GE (Canadian Standards Association approval) 
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~HB 
Battery Status 


Description When the ~HB command is sent to the printer, a data string is sent back to the 
host. The string starts with an <STX> control code sequence and terminates by an 
<ETX><CR><LF> control code sequence. 


Important ¢ This command only responds to mobile printers. 


Format ~HB 


Parameters: when the printer receives the command, it returns: 
<STX>bb.bb, hh. hh, bt<ETX><CR><LF> 


<STX> = ASCII start-of-text character 

bb.bb = current battery voltage reading to the nearest 1/4 volt 
hh.hh = current head voltage reading to the nearest 1/4 volt 
bt = battery temperature in Celsius 

<ETX> = ASCII end-of-text character 

<CR> = ASCII carriage return 

<LF> = ASCII line feed character 


Comments This command is used for the power-supply battery of the printer and should not 
be confused with the battery backed-up RAM. 
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Head Diagnostic 


ZPL Commands 
~HD 


Description The ~HD command echoes printer status information that includes the power 


supply and head temperature using the terminal emulator. 


Format ~HD 


Example « This is an example of the ~HD command: 


ead Temp = 2? 

mbient Temp = 686 

ead Test = Passed 

arkness Adjust = 23 

Pint Speed = 2 

lew Speed = 6 

ackfeed Speed = 2 
tatic_pitch_length = 6521 
ynamic_pitch_length = 6546 
ax_dynamic_pitch_length = 6546 
in_dynamic_pitch_length = 6537 
OMMAND PFR = “™ 
INTERFACE 
31 INTERFACE 
32 INTERFACE 
33 INTERFACE None 

34 INTERFACE None 

35 INTERFACE = None 
ynamic_top_position = 6668 


No ribbon A/D = 6666 


None 
None 
Front Panel 


wo 
i) 
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166 


A 
HF 
Host Format 
Description The *HF command sends stored formats to the host. 


Format *HFd,0,x 


This table identifies the parameters for this format: 


Parameters Details 


d = device torecall | Accepted Values: R:,E:,B:,and A: 
image Default Value: R: 


oO = image name Accepted Values: 1 to 8 alphanumeric characters 
Default Value: 1f a name is not specified, UNKNOWN is used 


x = extension Fixed Value: .ZPL 


—> Example « This example shows the sequence and results. 


Using a terminal emulator, you download this code to the printer: 
“XA 
“DFB: FILE1.ZPL 
*“FO100,100*A0,100 
“FDTEST“*ES 
“XZ 


Then you send this code to the printer: 
“XA 
“HEB: FILE1.ZPL 
“XZ 


The terminal emulator returns this code: 
“XA*DFFILEI, 
“FO100,100*%A0,100*FDTEST*FS 
“XZ 
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“HG 
Host Graphic 


Description The “HG command is used to upload graphics to the host. The graphic image 
can be stored for future use, or it can be downloaded to any Zebra printer. 


Format *HGd:o0.x 


This table identifies the parameters for this format: 


Parameters Details 


d = device location | Accepted Values: R:,E:,B:,and A: 


of object Default Value: search priority 
o = object name Accepted Values: 1 to 8 alphanumeric characters 
Default Value: if a name is not specified, UNKNOWN is used 
x = extension Fixed Value: . GRF 


Comments For more information on uploading graphics, see “HY on page 177. 
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AHH 


“HH 


Configuration Label Return 


Description The *HH command echoes printer configuration back to the host, using a 
terminal emulator. 


Format *HH 
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+18 

+800 

TEAR OFF 
NON-CONT I NUOUS 


WEB 
DIRECT—THERMAL 
656 6/8 MM 
6622 

22.@IN 557MM 


XON/XOFF 
NONE 


668 
NORMAL MODE 
<“>  '7EH 
<*> SEH 
<> 2CH 
ZPL II 

NO MOTION 
NO MOTION 
DEFAULT 
+800 

+9008 

626 

468 

658 

661 

cs 


864 8/MM FULL 
U32.18.2 <= 
U2.2.6.98.A 
CUSTOMIZED 


1824... ececenne 


616.663 .605 .690 
255.255.255.608 
616.603 . G05 .461 


Example « This is an example of the *HH command: 


DARKNESS 

TEAR OFF 

PRINT MODE 
MEDIA TYPE 
SENSOR TYPE 
PRINT METHOD 
PRINT WIDTH 
LABEL LENGTH 
MAXIMUM LENGTH 
BAUD 

DATA BITS 
PARITY 

HOST HANDSHAKE 
PROTOCOL 
NETWORK ID 
COMMUNI CATIONS 
CONTROL PREFIX 
FORMAT PREFIX 
DELIMITER CHAR 
ZPL MODE 

MEDIA POWER UP 
HEAD CLOSE 
BACKFEED 

LABEL TOP 

LEFT POSITION 
WEB $ 


MEDIA S. 

MARK S$. 

MARK MED S. 
MODES ENABLED 
MODES DISABLED 
RESOLUTION 
FIRMWARE 
HARDWARE ID 
CONFIGURATION 
RAM 


MEMORY CARD 
ONBOARD FLASH 
FORMAT CONVERT 
OPTION 

RTC DATE 

RTC TIME 

IP RESOLUTION 
IP PROTOCOL 

IP ADDRESS 
SUBNET MASK 
DEFAULT GATEWAY 
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~HI 


Host Identification 


Description The ~HI command is designed to be sent from the host to the Zebra printer to 
retrieve information. Upon receipt, the printer responds with information on the model, 
software version, dots-per-millimeter setting, memory size, and any detected objects. 


Format ~HI 


When the printer receives this command, it returns: 


XXXXXX,V1.0.0,dpm, 00OOKB,X 
XXXXXX = model of Zebra printer 
V1.0.0 = version of software 
dpm = dots/mm 

6, 8, 12, or 24 dots/mm printheads 
000KB = memory 

512KB = 1/2 MB 


1024KB = 1 MB 
2048KB = 2MB 
4096KB = 4MB 
8192KB = 8MB 


x = recognizable objects 
only options specific to printer are shown (cutter, options, et cetera.) 
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~HM 
Host RAM Status 


Description Sending ~HM to the printer immediately returns a memory status message to 
the host. Use this command whenever you need to know the printer’s RAM status. 


When ~HM is sent to the Zebra printer, a line of data containing information on the total 
amount, maximum amount, and available amount of memory is sent back to the host. 


Format ~HM 


==> Example ¢ This example shows when the ~HM is sent to the printer, a line of data containing 
three numbers are sent back to the host. Each set of numbers is identified and explained in the 
table that follows: 


2 


1 —3584, 3586, 3586 I~ 3 


1 The total amount of RAM (in kilobytes) installed in the printer. In 
this example, the printer has 1024K RAM installed. 
2 The maximum amount of RAM (in kilobytes) available to the 
user. In this example, the printer has a maximum of 780K RAM 
available. 
3 The amount of RAM (in kilobytes) currently available to the user. 
In this example, there is 730K of RAM in the printer currently 
available to the user. 


Comments Memory taken up by bitmaps is included in the currently available memory 
value (due to “MCN). 


Downloading a graphic image, fonts, or saving a bitmap affects only the amount of RAM. The 
total amount of RAM and maximum amount of RAM does not change after the printer is 
turned on. 
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Host Status Return 


ZPL Commands 
~HS 


Description When the host sends ~HS to the printer, the printer sends three data strings 
back. Each string starts with an <STX> control code and is terminated by an 


separate line. 


String 1 


<ETX><CR><LF> control code sequence. To avoid confusion, the host prints each string on a 


<STX>aaa,b,c,dddd,eee, f,g,h,iii,j,k,1<ETX><CR><LF> 


aaa = communication (interface) settings* 

b = paper out flag (1 = paper out) 

c = pause flag (1 = pause active) 

dddd = _ label length (value in number of dots) 

eee = number of formats in receive buffer 

£ = buffer full flag(1 = receive buffer full) 

g = communications diagnostic mode flag (1 = diagnostic mode active) 
h = partial format flag (1 = partial format in progress) 
iii = unused (always 000) 

j = corrupt RAM flag (1 = configuration data lost) 

k = temperature range (1 = under temperature) 

1 = temperature range (1 = over temperature) 


* This string specifies the printer’s baud rate, number of data bits, number of stop bits, parity 
setting, and type of handshaking. This value is a three-digit decimal representation of an eight- 
bit binary number. To evaluate this parameter, first convert the decimal number to a binary 


number. 


The nine-digit binary number is read according to this table: 


2 
aaa =a‘ a’ a® a° a‘ a a a! a° 


= Handshake 
0 = Xon/Xoff 
1=DTR 


= Parity Odd/Even 
0 = Odd 
1 = Even 


° = Disable/Enable 
0 = Disable 
1 = Enable 


= Stop Bits 
0 = 2 Bits 
1=1 Bit 


° = Data Bits 
0 =7 Bits 
1 =8 Bits 
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8 .2,1,0 
a aaa =Baud 


0 000 = 110 

0 001 = 300 

0 010 = 600 

0 011 = 1200 

0 100 = 2400 

0 101 = 4800 

0 110 = 9600 

0 111 = 19200 

1 000 = 28800 (available only on certain printer models) 
1 001 = 38400 (available only on certain printer models) 
1 010 = 57600 (available only on certain printer models) 
1 011 = 14400 
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String 2 


<STX>mmm,n,o,p,qg,r,s,t, uuuuuuuu, V, WWWw<ETX><CR><LF> 


mmm = function settings* 
n = unused 
fo) = head up flag (1 = head in up position) 
p = ribbon out flag (1 = ribbon out) 
gq = thermal transfer mode flag (1_ = Thermal Transfer Mode selected) 
ia = Print Mode 
Q = Rewind 
1 = Peel-Off 
2 = Tear-Off 
3 = Cutter 
4 = Applicator 
Ss = print width mode 
te = label waiting flag (1 = label waiting in Peel-off Mode) 
uuuuuu = _ labels remaining in batch 
uu 
Vv = format while printing flag (always 1) 
www = number of graphic images stored in memory 


* This string specifies the printer’s media type, sensor profile status, and communication 
diagnostics status. As in String 1, this is a three-digit decimal representation of an eight-bit 
binary number. First, convert the decimal number to a binary number. 


The eight-digit binary number is read according to this table: 


mmm=m7 m6 m5 m4 m3 m2 ml m0 


m7 = Media Type m4 m3 m2 ml = Unused 
0 = Die-Cut 0 = Off 
1 = Continuous 1=On 


m6 = Sensor Profile m0 = Print Mode 
0 = Off 0 = Direct Thermal 
1 = Thermal Transfer 


m5 = Communications Diagnostics 
0 = Off 
1=On 


String 3 
<STX>xXxXxXxX, YXETX><CR><LF> 


XXXX = password 


0 (static RAM not installed) 


K 
ll 


1 (static RAM installed) 
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~HU 
Return ZebraNet Alert Configuration 


Description This command returns the table of configured ZebraNet Alert settings to the 
host. 


Format ~HU 


—p> Example « If the ~HU command is sent to the printer with existing Alert messages set to go 
to e-mail and SNMP traps, the data returned would look something like the information 
below. See “SX on page 269 for complete information on the individual parameter settings. 


B,C,Y,Y,ADMIN@COMPANY .COM, 0 
J,F,Y,Y,7,0 
Cp Bp Xg-X74-0 
D,F,Y,;Y,7,0 
E,F,Y,N,,0 


F,F,Y,N,,0 

H,C,Y,N,ADMIN@COMPANY .COM, 0 
N,C,Y,¥Y,ADMIN@COMPANY . COM, 0 
0,C,Y,¥Y,ADMIN@COMPANY .COM, 0 
P,C,Y,Y,ADMIN@COMPANY .COM, 0 


The first line indicates that condition B (ribbon out) is routed to destination C (e-mail address). 


The next two characters, Y and Y, indicate that the condition set and condition clear options 
have been set to yes. 


The following entry is the destination that the Alert e-mail should be sent to; in this example it 
is admin@company.com. 


The last figure seen in the first line is 0, which is the port number. 


Each line shows the settings for a different Alert condition as defined in the *SX command. 
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A 
HV 
Host Verification 
Description This command is used to return data from specified fields, along with an 
optional ASCII header, to the host computer. The command can be used with any field that has 


been assigned a number with the “RT command or the “FN and “RF commands. 


Format *HV#,n,h 


This table identifies the parameters for this format: 


Parameters Details 

# = field number The value assigned to this parameter should be the same as the one 
specified with used in another command. 
another Accepted Values: 0 to 9999 
command Default Value: 0 


n = number of bytes | Accepted Values: 1 to 256 

to be returned Default Value: 64 

header Header to be returned with the data. 
Accepted Values: 0 to 3072 bytes 
Default Value: no header 


D- 
ll 
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AHW 


Description “HW is used to transmit a directory listing of objects in a specific memory area 
(storage device) back to the host device. This command returns a formatted ASCII string of 
object names to the host. 


Each object is listed on a line and has a fixed length. The total length of a line is also fixed. 
Each line listing an object begins with the asterisk (*) followed by a blank space. There are 
eight spaces for the object name, followed by a period and three spaces for the extension. The 
extension is followed by two blank spaces, six spaces for the object size, two blank spaces, and 
three spaces for option flags (reserved for future use). The format looks like this: 


<STX><CR><LF> 
DIR R: <CR><LF> 
*Name.ext (2sp.) (6 obj. sz.) (2sp.) (3 option flags) 


*Name.ext (2sp.) (6 obj. sz.) (2sp.) (3 option flags) 
<CR><LF> 


-XXXxXxXxx bytes free 


<CR><LF> 


<ETX> 


<STX> = start of text 


<CR><LR> = carriage return/line feed 


<ETX> = end on text 


The command might be used in a stand-alone file to be issued to the printer at any time. The 
printer returns the directory listing as soon as possible, based on other tasks it might be 
performing when the command is received. 


This command, like all * (caret) commands, is processed in the order that it is received by the 
printer. 


Format *HWd:o.x 


This table identifies the parameters for this format: 


Parameters Details 

d = location to Accepted Values: R:,H:,B:,A:and Z: 
retrieve object Default Value: R: 
listing 

o = object name Accepted Values: 1 to 8 alphanumeric characters 


Default Value: asterisk (*). A question mark (?) can also be used. 


™* 
| 


= extension Accepted Values: any extension conforming to Zebra conventions 
Default Value: asterisk (*). A question mark (?) can also be used. 
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Example « Listed is an example of the “HW command to retrieve from information R: 


“XA 


“HWR: *.* 


“XZ 


Example « The printer returned this information as the Host Directory Listing:—DI 
R:*. 


* 


* 


* 


* 


* 


* 


-794292 bytes free R:RAM 


* 


R: 
Re 
R: 
R: 
R: 


R: 


ARIALN1.FNT 
ARIALN2.FNT 
ARIALN3.FNT 
ARIALN4.FNT 
ARIALN.FNT 4 


91 
91 
91 
91 
19140 


ZEBRA.GRF 84 
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Description The *HY command is an extension of the “HG command. “HY is used to 


upload graphic objects from the printer in any supported format. 


Format *HYd:0.x 


This table identifies the parameters for this format: 


Parameters Details 


d = location of object | Accepted Values: R:,E:,B:,and A: 


Default Value: search priority 


o = object name Accepted Values: 1 to 8 alphanumeric characters 
Default Value: an object name must be specified 
x = extension Accepted Values: 
G = .GRF (raw bitmap format) 
P = .PNG (compressed bitmap format) 


Default Value: format of stored image 


Comments The image is uploaded in the form of a ~DY command. The data field of the 


returned ~DY command is always encoded in the ZB64 format. 
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A 
HZ 
Display Description Information 
Description The *HZ command is used for returning printer description information in 
XML format. The printer returns information on format parameters, object directories, 


individual object data, and print status information. 


Format *HZb 


This table identifies the parameters for this format: 


Parameters Details 
b = display Accepted Values: 
description to a = display all information 
Teun f£ = display printer format setting information 
1 = display object directory listing information 
o = display individual object data information 
rx = display printer status information 
Default Value: if the value is missing or invalid, the command is 
ignored 


Format *HZO,d:0.x,1 


This table identifies the parameters for this format: 


Parameters Details 
d = location of stored | Accepted Values: R:,E:,B:,and A: 
object Default Value: R: 


o = object name Accepted Values: 1 to 8, or 1 to 16 alphanumeric characters 
based on parameter 1. 
Default Value: if a name is not specified, UNKNOWN is used. 
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Parameters 


x = extension 


1 = long filename 
support 


ZPL Commands 
AHZ 


Details 


Supported extensions for objects (parameter 0) include: 
. FNT — font 
. GRF — graphic 
. PNG — compressed graphic 
. ZPL — stored format 
. DAT — encoding table 
. ZOB — downloadable object 
. STO — Alert data file 
Accepted Values: 
Y = Yes 
If Y, the object data stores the filename as 16 characters. 
The data is only compatible with firmware V60.13.0.5 
and above. 
N = No 
If N, the object data stores the filename as 8 characters. 
The data is forward and backward compatible with all 


versions of firmware. 
Default Value: N 


Example « This example shows the object data information for the object SAMPLE . GRF 


located on R:. 
“XA 


“HZO,R:SAMPLE.GRF 


“XZ 
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“ID 
Object Delete 


Description The “ID command deletes objects, graphics, fonts, and stored formats from 
storage areas. Objects can be deleted selectively or in groups. This command can be used 
within a printing format to delete objects before saving new ones, or in a stand-alone format to 
delete objects. 


The image name and extension support the use of the asterisk (*) as a wild card. This allows 
you to easily delete a selected groups of objects. 


Format *IDd:o.x 


This table identifies the parameters for this format: 


Parameters Details 
d = location of stored | Accepted Values: R:,E:,B:,and A: 
object Default Value: R: 
o = object name Accepted Values: any 1 to 8 character name 
Default Value: if a name is not specified, UNKNOWN is used 
xX = extension Accepted Values: any extension conforming to Zebra conventions 
Default Value: .GRF 
——= p> Example « To delete stored formats from DRAM: 
“XA 
“IDR: *.ZPL°FS 
“XZ 
== Example « To delete formats and images named SAMPLE from DRAM, regardless of the 
extension: 
XA 
“TDR: SAMPLE. **FS 
“XZ, 
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=P Example « To delete the image SAMPLE1 .GRF prior to storing SAMPLE2 .GRF: 
“XA 
“FO25,25°AD,18,10 
“FDDelete*FS 
“FO25,45*°AD,18,10 
“FDthen Save“*FS 
“TDR: SAMPLE1.GRF*FS 
“TSR: SAMPLE2.GRF*FS*XZ 


—— > Example « In this the * is a wild card, indicating that all objects with the . GRF extension are 
deleted: 


“XA 
“IDR: *.GRECES 
“XZ 


Comments When an object is deleted from R:, the object can no longer be used and 
memory is available for storage. This applies only to R: memory. With the other memory types 
(A:, B:, E:) the deleted object is no longer available. The memory space recovers when an 
automatic defragmentation or initiallization occurs. 


The “ID command also frees up the uncompressed version of the object in DRAM. 


If the name is specified as * . ZOB, all downloaded bar code fonts (or other objects) are 
deleted. 


a] 


B:,and A: device, the 


If the named downloadable object cannot be found in the R:, E: 
“ID command is ignored. 


’ 
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AIL 


Image Load 


Description The *IL command is used at the beginning of a label format to load a stored 
image of a format and merge it with additional data. The image is always positioned at 


“FOO, 0. 


Important ¢ See “/S on page 185. 


Using this technique to overlay the image of constant information with variable data greatly 
increases the throughput of the label format. 


Format *ILd:o.x 


This table identifies the parameters for this format: 


Parameters 


d = location of stored 


Details 


Accepted Values: R:,E:,B:,and A: 


object Default Value: R: 
o = object name Accepted Values: 1 to 8 alphanumeric characters 
Default Value: if a name is not specified, UNKNOWN is used 
x = extension Fixed Value: .GRF 
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——p»> Example « This example recalls the stored image SAMPLE2 . GRF from DRAM and 
overlays it with the additional data. The graphic was stored using the “IS command. For the 
stored label format, see the ‘JS on page 185 command. 


ZPL Il CODE GENERATED LABEL 
“XA 
“ILR:SAMPLE2.GRF*FS ZEBRA 
“CFD, 36,20 
AFO15,210 TECHNOLOGIES CORP 
“FD900123“°FS ARTICLE# LOCATION 
“FO218,210 966123 {LINE 12 
“FDLINE 12°FS 
“FO15, 360*AD DESCRIPTION 
“FDZEBRA THERMAL‘*FS ZEBRA THERMAL 
“FO15,400*AD TRANSFER PRINTER 
“FDTRANSFER PRINTER‘*FS 
“FO1L5, 540 REQ.NO. WORK NUMBER 
“FD54321°FS 54321 458643 
“FO220,530 
“FOILS, 670°A0, 27, 18 Label Formats! 
“FDTesting Stored Graphic*FS 
“FO15,700*°A0,27,18 
“FDLabel Formats! !*FS 
AXZ 
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“IM 


Image Move 


Description The *IM command performs a direct move of an image from storage area into 
the bitmap. The command is identical to the *XG command (Recall Graphic), except there are 
no sizing parameters. 


Format *IMd:o.x 


This table identifies the parameters for this format: 


Parameters Details 
d = location of stored | Accepted Values: R:,E:,B:,and A: 
object Default Value: search priority 
o = object name Accepted Values: 1 to 8 alphanumeric characters 
Default Value: 1f a name is not specified, UNKNOWN is used 
x = extension Fixed Value: .GRE 
——=> Example « This example moves the image SAMPLE. GRF from DRAM and prints it in 
several locations in its original size. 
“XA 
“FO100,100* IMR: SAMPLE.GRF“FS 
“FO100,200* IMR: SAMPLE.GRF“FS 
“FO100,300* IMR: SAMPLE.GRF“FS 
“FO100, 400* IMR: SAMPLE.GRF“FS 
“FO100,500* IMR: SAMPLE.GRF“FS 


“XZ 


Comments By using the *FO command, the graphic image can be positioned anywhere on 
the label. 


The difference between “IM and *XG: “IM does not have magnification, and therefore might 
require less formatting time. However, to take advantage of this, the image must be at a 8-, 16- 
, or 32-bit boundary. 
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Description 
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AIS 


The “IS command is used within a label format to save that format as a 


graphic image, rather than as a ZPL II script. It is typically used toward the end ofa script. The 
saved image can later be recalled with virtually no formatting time and overlaid with variable 
data to form a complete label. 


Using this technique to overlay the image of constant information with the variable data 
greatly increases the throughput of the label format. 


Important ¢ See ‘JZ on page 182. 


Format *ISd:0.x,p 


This table ide 


Parameters 


ntifies the parameters for this format: 


Details 


d = location of stored | Accepted Values: R:,E:,B:,and A: 


object Default Value: R: 
o = object name Accepted Values: 1 to 8 alphanumeric characters 
Default Value: if a name is not specified, UNKNOWN is used 
x = extension Accepted Values: .GRF or . PNG 


Default Value: .GRF 


p = printimage after | Accepted Values: 
storing N = no 


Y = yes 
Default Value: Y 
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[S command to save a label format to DRAM. 


Example « This is an example of using the *1 


The name used to store the graphic is SAMPLE2 . GRF. 


ZPL Il CODE 


GENERATED LABEL 


“XA 
“LH10,15*FWN“BY3,3,85*CFD, 36 
“GB430,750,4°FS 
“FO10,170*%GB200,144,2°FS 
“FO10,318*GB410,174,2°FS 
“FO212,170*%GB206,144,2*FS 
“FO10,498*GB200,120,2*FSR 
“FO212,498*GB209,120,2°FS 
“FO4,150*GB422,10,10*FS 
“FO135,20*A0, 70, 60 
“FDZEBRA“‘FS 

“FO80,100*A0, 40,30 
“FDTECHNOLOGIES CORP*FS 
“FO15,180*CFD,18,10*FS 
“FDARTICLE#“FS 

“FO218,180 

“FDLOCATION*’FS 

“FO15, 328 
“FDDESCRIPTION“‘FS 

“FO15, 508 

“FDREQ.NO.*FS 

“FO220,508 

“FDWORK NUMBER“‘FS 

“FO15, 630*AD, 36,20 
“FDCOMMENTS: °FS 

“ISR: SAMPLE2.GRF,Y 

“XZ 


ZEBRA 
TECHNOLOGIES CORP 


ARTICLE# LOCATION 


DESCRIPTION 


WORK NUMBER 


COMMENTS = 
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~JA 
Cancel All 


Description The ~JA command cancels all format commands in the buffer. It also cancels 
any batches that are printing. 


The printer stops after the current label is finished printing. All internal buffers are cleared of 
data and the DATA LED turn off. 


Submitting this command to the printer scans the buffer and deletes only the data before the 
~JA in the input buffer — it does not scan the remainder of the buffer for additional ~JA 
commands. 


Format ~JA 
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“JB 


Initialize Flash Memory 


Description The *JB command is used to initialize various types of Flash memory 
available in the Zebra printers. 


Format *JBa 


This table identifies the parameters for this format: 


Parameters Details 
a = device to Acceptable Values: 
initialize A = Compact Flash memory 
B = Flash card (PCMCIA) 


E = internal Flash memory 
Default Value: a device must be specified 


—=p> Example ¢ This is an example of initializing the different types of flash memory: 


“JBA — initializes initial Compact Flash memory when installed in the printer. 


“JBB — initializes the optional Flash card when installed in the printer. 


“JBE — initializes the optional Flash memory when installed in the printer. 


Note « Initializing memory can take several minutes. Be sure to allow sufficient time for the 
initialization to complete before power cycling the printer. 
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~JB 
Reset Optional Memory 


Description The ~JB command is used for these conditions: 


¢« The ~JB command must be sent to the printer if the battery supplying power to the battery 
powered memory card fails and is replaced. A bad battery shows a battery dead condition 
on the Printer Configuration Label. 


¢ The ~JB command can also be used to intentionally clear (reinitialize) the B : memory 
card. The card must not be write protected. 


Format ~JB 


Comments Ifthe battery is replaced and this command is not sent to the printer, the memory 
card cannot function. 


6/9/06 ZPL II Programming Guide For x.10 through x.13 Firmware 45541L-003 Rev. A 


190 | ZPL Commands 
~JC 


~JC 
Set Media Sensor Calibration 


Description The ~JC command is used to force a label length measurement and adjust the 
media and ribbon sensor values. 


Format ~JC 


Comments In Continuous Mode, only the media and ribbon sensors are calibrated. 
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~JD 
Enable Communications Diagnostics 


Description The ~JD command initiates Diagnostic Mode, which produces an ASCII 
printout (using current label length and full width of printer) of all characters received by the 
printer. This printout includes the ASCII characters, the hexadecimal value, and any 


communication errors. 


Format ~JD 
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~JE 


Disable Diagnostics 


Description The ~JE command cancels Diagnostic Mode and returns the printer to normal 
label printing. 


Format ~J] 


{| 
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~JF 
Set Battery Condition 


Description There are two low battery voltage levels sensed by the P4/PT400™ printers. 
When battery voltage goes below the first level, the green LED begins flashing as a warning 
but printing continues. When this warning occurs, it is recommended to recharge the battery. 


As printing continues, a second low voltage level is reached. At this point, both green and 
orange LEDs flash as a warning, and printing automatically pauses. 


When pause on low voltage is active (~ JFY) and the battery voltage level falls below the 
second /ow voltage level, printing pauses and an error condition is displayed as an indication 
that the printer should be plugged into the battery charger. By pressing FEED, printing 
continues on a label-by-label basis, but there is a high risk of losing label format information 
due to the continued decrease of battery voltage. 


When pause on low voltage is not active (~ JEN), and the battery voltage level falls below the 
second /Jow voltage level, printing continues and the orange LED remains off. If the battery 
voltage continues to decrease, label information could be lost and cause the printer to stop 
operating. This option should be selected only when the printer is connected to the Car Battery 
Adapter. From time to time the printer might sense that battery voltage is below the first ow 
voltage level, but due to the continuous recharging of the car battery, further loss of battery 
voltage is not a concern and printing continues. 


If this option is not selected when using the Car Battery Adapter, you might need to press 
FEED to take the printer out of Pause Mode and print each label. 


Format ~JFp 


This table identifies the parameters for this format: 


Parameters Details 
Pp = pause on low Accepted Values: Y (pause on low voltage) or N (do not pause) 
voltage N is suggested when the printer is powered by the Car Battery 
Adapter. 
Default Value: Y 
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~JG 


Graphing Sensor Calibration 


Description The ~JG command is used to force a label length measurement, recalibrate the 
media and ribbon sensors, and print a graph (media sensor profile) of the sensor values. 


Format ~JG 


——p> Example « Sending the ~ JG command to the printer produces a series of labels resembling 


this image: 


GENERATED LABELS 


RIBBON _ 


| 
a 


DN RIBB 


RIBBON 


)} MEDIA MEDIA MEDIA MEDIA MEDIA 
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AJJ 
Set Auxiliary Port 


Description The *JJ command allows you to control an online verifier or applicator 
device. 


Format *JJa,b,c,d,e,f 


This table identifies the parameters for this format: 


Parameters Details 


a = operational mode | Accepted Values: 
for auxiliary port 0 = off 


1 = reprint on error—the printer stops on a label with a 
verification error. When PAUSE is pressed, the label 
reprints (if “JZ is set to reprint). Ifa bar code is near 
the upper edge of a label, the label feeds out far enough 
for the bar code to be verified and then backfeeds to 
allow the next label to be printed and verified. 

2 = maximum throughput—the printer stops when a 
verification error is detected. The printer starts printing 
the next label while the verifier is still checking the 
previous label. This mode provides maximum 
throughput, but does not allow the printer to stop 
immediately on a label with a verification error. 


Default Value: 0 


b = application mode | Accepted Values: 
0 = off 
1 = End Print signal normally high, and low only when the 
printer is moving the label forward. 
2 = End Print signal normally low, and high only when the 
printer is moving the label forward. 
3 = End Print signal normally high, and low for 20 ms when 
a label has been printed and positioned. 
4 = End Print signal normally low, and high for 20 ms when 
a label has been printed and positioned. 
Default Value: 0 


c = application mode | Accepted Values: 
start signal print p = Pulse Mode — Start Print signal must be de-asserted 
before it can be asserted for the next label. 

1 = Level Mode — Start Print signal does not need to be de- 
asserted to print the next label. As long as the Start Print 
signal is low and a label is formatted, a label prints. 


Default Value: 0 
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Parameters 


d = application label 
error mode 


Details 


Accepted Values: 

error mode—the printer asserts the Service Required 

signal (svce_req - pin 10) on the application port, enters 

into Pause Mode, and displays an error message on the 

LCD. 

f£ = Feed Mode—a blank label prints when the web is not 
found where expected to sync the printer to the media. 


Default Value: £ 


e= 


e = reprint mode 


Accepted Values: 

enabled—the last label reprints after the signal is 
asserted. If a label is canceled, the label to be reprinted 
is also canceled. This mode consumes more memory 
because the last printed label is not released until it 


e= 


reprints. 
d = disabled—printer ignores the Reprint signal. 


Default Value: d. 


£ = ribbon low mode 


Accepted Values: 
e = enabled — printer warning issued when ribbon low. 
da = disabled — printer warning not issued when ribbon low. 


Default Value: e 
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~JL 
Set Label Length 


Description The ~JL command is used to set the label length. Depending on the size of the 
label, the printer feeds one or more blank labels. 


Format ~JL 
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“JM 


Set Dots per Millimeter 


Description The *JM command lowers the density of the print—24 dots/mm becomes 12, 
12 dots/mm becomes 6, 8 dots/mm becomes 4, and 6 dots/mm becomes 3. *JM also affects the 
field origin (“FO) placement on the label (see example below). 


When sent to the printer, the “JM command doubles the format size of the label. Depending on 
the printhead, normal dot-per-millimeter capabilities for a Zebra printer are 12 dots/mm (304 
dots/inch), 8 dots/mm (203 dots/inch) or 6 dots/mm (153 dots/inch). 


This command must be entered before the first “E'S command in a format. The effects of “JM 
are persistent. 


Format *JMn 


This table identifies the parameters for this format: 


Parameters Details 
n = set dots per Accepted Values: 
millimeter A = 24 dots/mm, 12 dots/mm, 8 dots/mm or 6 dots/mm 
B = 12 dots/mm, 6 dots/mm, 4 dots/mm or 3 dots/mm 
Default Value: A 
= Example « This example of the affects of alternating the dots per millimeter: 
ZPL Il CODE GENERATED LABEL 

“XA 
nee TTL 


“FO100,100 
“B2N,50,Y,N,N 
“FD1234567890°FS 
“XS 


“XA 

“JMB“FS 
“FO100,100 
“B2N,50,Y,N,N 
“FD1234567890°FS 
“XZ 


= 


— 


123456 7398) 


Comments If “JMB is used, the UPS MaxiCode bar code becomes out of specification. 
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~JN 
Head Test Fatal 


Description The ~JN command turns on the head test option. When activated, ~ JN causes 
the printer to halt when a head test failure is encountered. 


Once an error is encountered the printer remains in error mode until the head test is turned off 
(~JO) or power is cycled. 


Format ~JN 


Comments Ifthe communications buffer is full, the printer is not able to receive data. In this 
condition, the ~JO command is not received by the printer. 
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~JO 
Head Test Non-Fatal 


Description The ~JO command turns off the head test option. ~JO is the default printhead 
test condition and overrides a failure of printhead element status check. This state is changed 
when the printer receives a ~ JN (Head Test Fatal) command. The printhead test does not 


produce an error when ~JO is active. 


Format ~JO 
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~JP 
Pause and Cancel Format 


Description The ~JP command clears the format currently being processed and places the 
printer into Pause Mode. 


The command clears the next format that would print, or the oldest format from the buffer. 
Each subsequent ~ JP command clears the next buffered format until the buffer is empty. The 
DATA indicator turns off when the buffer is empty and no data is being transmitted. 


Issuing the ~ JP command is identical to using CANCEL on the printer, but the printer does 
not have to be in Pause Mode first. 


Format ~JP 
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~JR 
Power On Reset 


Description The ~JR command resets all of the printer’s internal software, performs a 
power-on self-test (POST), clears the buffer and DRAM, and resets communication 
parameters and default values. Issuing a ~ JR command performs the same function as a 
manual power-on reset. 


Format ~JR 
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AJS 
Sensor Select 


Format *JSa 


Note * This command is only for the Z-Series and S4M printers, only. 


This table identifies the parameters for this format: 


Parameters Details 


a = sensor selection | Accepted Values: 
A = auto select 
R 
a transmissive sensor 

Default Value: Z-Series = Aandthe S4M = R 


reflective sensor 
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~JS 


Change Backfeed Sequence 
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Description The ~JS command is used to control the backfeed sequence. This command 
can be used on printers with or without built-in cutters. 


These are the primary applications: 
* to allow programming of the rest point of the cut edge of continuous media. 
* provide immediate backfeed after peel-off when the printer is used in a print/apply 


application configuration. 


This command stays in effect only until the printer is turned off, a new ~JS command is sent, 
or the setting is changed on the control panel. When a ~JS command is encountered, it 
overrides the current control panel setting for the Backfeed Sequence. 


The most common way of eliminating backfeed is to operate in Rewind Mode. Rewind Mode 
does not backfeed at all. After a label prints, the leading edge of the next label is placed at the 
print line. This eliminates the need to backfeed and does not introduce a non printable area at 
the leading edge or bottom of the label. It also does not allow the label to be taken from the 
printer because it is not fed out from under the printhead. 


Running in another mode with backfeed turned off allows the label to be removed and 
eliminates the time-reduction of the backfeed sequence. 


Format ~JSb 


This table identifies the parameters for this format: 


Parameters Details 


b = backfeed order in | Accepted Values: 


relation to A = 100 percent backfeed after printing and cutting 
printing B 


0 percent backfeed after printing and cutting, and 
100 percent before printing the next label 
normal — 90 percent backfeed after label is printed 


N 
O 
10 to 90 = percentage value 


off — turn backfeed off completely 


The value entered must be a multiple of 10. Values not 

divisible by 10 are rounded to the nearest acceptable value. 

For example, ~JS55 is accepted as 50 percent backfeed. 
Default Value: N 


Comments When using a specific value, the difference between the value entered and 100 
percent is calculated before the next label is printed. For example, a value of 40 means 40 
percent of the backfeed takes place after the label is cut or removed. The remaining 60 percent 
takes place before the next label is printed. 
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The value for this command is also reflected in the Backfeed parameter on the printer 
configuration label. 


For ~JSN — the Backfeed parameter is listed as DEFAULT 

For ~JSA — or 100 the Backfeed parameter is listed as AFTER 

For ~JSB — or 0 the Backfeed parameter is listed as BEFORE 

For ~JS10 — to 90 the Backfeed parameter is listed as the value entered 
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“JT 


Head Test Interval 


Description The *JT command allows you to change the printhead test interval from every 
100 labels to any desired interval. With the “JT command, the printer is allowed to run the 
test after printing a label. When a parameter is defined, the printer runs the test after printing a 


set amount of labels. 


The printer’s default head test state is off. Parameters for running the printhead test are defined 


by the user. 


Format *JT####,a,b,c 


This table identifies the parameters for this format: 


Parameters 


#### = four-digit 
number of labels 
printed between 
head tests 


Details 


Accepted Values: 0000 to 9999 
Ifa value greater than 9999 is entered, it is ignored. 
Default Value: 0000 (off) 


a = manually select 
range of 
elements to test 


Accepted Values: 
N = no 
Y = yes 
Initial Value at Power-up: N 


b = first element to 
check when 
parameter a is 
Y 


Accepted Values: 0 to 9999 
Initial Value at Power-up: 0 


c = last element to 
check when 
parameter a is Y 


Accepted Values: 0 to 9999 
Initial Value at Power-up: 9999 


Comments The “JT command supports testing a range of print elements. The printer 
automatically selects the test range by tracking which elements have been used since the 


previous test. 


“ JT also turns on Automatic Mode to specify the first and last elements for the head test. This 
makes it possible to select any specific area of the label or the entire print width. 


If the last element selected is greater than the print width selected, the test stops at the selected 


print width. 


Whenever the head test command is received, a head test is performed on the next label unless 
the count is set to 0 (zero). 
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“JU 
Configuration Update 
Description The “JU command sets the active configuration for the printer. 


Format *JUa 


This table identifies the parameters for this format: 


Parameters Details 
a = active Accepted Values: 
configuration F = reload factory values 


These values are lost at power-off if not saved with “JUS. 
R = recall last saved values 


S = save current settings 


These values are used at power-on. 
Default Value: a value must be specified 
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“JW 


Set Ribbon Tension 


Description “JW sets the ribbon tension for the printer it is sent to. 


Format *Jwt 


This table identifies the parameters for this format: 


Parameters 


t = tension 


Details 
Accepted Values: 
L = low 


M = medium 
H = high 
Default Value: a value must be specified 


Comments “JW is used only for P4X series printers. 
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~JX 
Cancel Current Partially Input Format 


Description The ~JX command cancels a format currently being sent to the printer. It does 
not affect any formats currently being printed, or any subsequent formats that might be sent. 


Format ~JxX 
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AJZ 
Reprint After Error 


Description The *JZ command reprints a partially printed label caused by a Ribbon 
Out, Media Out, orHead Open error condition. The label is reprinted as soon as the 
error condition is corrected. 


This command remains active until another “JZ command is sent to the printer or the printer 
is turned off. 


Format *JZa 


This table identifies the parameters for this format: 


Parameters Details 

a = reprint after error | Accepted Values: 
N = no 

Y = yes 


Initial Value at Power-up: Y 


Comments “*JZ sets the error mode for the printer. If “JZ changes, only labels printed after 
the change are affected. 


If the parameter is missing or incorrect, the command is ignored. 
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~KB 
Kill Battery (Battery Discharge Mode) 


Description To maintain performance of the rechargeable battery in the portable printers, 
the battery must be fully discharged and recharged regularly. The ~KB command places the 
printer in battery discharge mode. This allows the battery to be drained without actually 
printing. 


Format ~KB 


Comments While the printer is in Discharge Mode, the green power LED flashes in groups 
of three flashes. 


Discharge Mode might be terminated by sending a printing format to the printer or by pressing 
either of the control panel keys. 


If the battery charger is plugged into the printer, the battery is automatically recharged once the 
discharge process is completed. 
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Select Date and Time Format (for Real Time Clock) 
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Description 
information p 


The “KD command selects the format that the Real-Time Clock’s date and time 
resents as on a configuration label. This is also displayed on the Printer Idle 


LCD control panel display, and displayed while setting the date and time. 


Format *KDa 


This table ide 


Parameters 


ntifies the parameters for this format: 


Details 


a = value of date and | Accepted Values: 


time format 0 = normal, displays Version Number of firmware 
1 = MM/DD/YY (24-hour clock) 
2 = MM/DD/YY (12-hour clock) 
3 = DD/MM/YY (24-hour clock) 


Comments 


4 = DD/MM/YY (12-hour clock) 
Default Value: 0 


If the Real-Time Clock hardware is not present, Display Mode is set to 0 


(Version Number). 


If Display Mode is set to 0 (Version Number) and the Real-Time Clock hardware is present, 
the date and time format on the configuration label is presented in format 1. 


If Display Mode is set to 0 (Version Number) and the Real-Time Clock hardware is present, 
the date and time format on the control panel display is presented in format 1. 
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ZPL Commands 
AKL 


Define Language 


Description 


The “KL command selects the language displayed on the control panel. 


Format *KLa 


This table identifies the parameters for this format: 


Parameters Details 

a = language Accepted Values: 
1 = English 
2 = Spanish 
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= French 
= German 
= Italian 


3 
4 
5 
6 = Norwegian 
7 = Portuguese 
8 = Swedish 
9 = Danish 

0 = Spanish2 
11 = Dutch 

2 = Finnish 


13 = Japanese 
Default Value: 1 
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AKN 
Define Printer Name 


Description The printer’s network name and description can be set using the “KN 
command. “KN is designed to make your Zebra printer easy for users to identify. The name the 
administrator designates is listed on the configuration label and on the Web page generated by 
the printer. 


Format *KNa,b 


This table identifies the parameters for this format: 


Parameters Details 


a = printer name Accepted Values: up to 16 alphanumeric characters 


Default Value: if a value is not entered, the parameter is ignored 
If more than 16 characters are entered, only the first 16 are 


used. 
b = printer Accepted Values: up to 35 alphanumeric characters 
description Default Value: if a value is not entered, the parameter is ignored 
If more than 35 characters are entered, only the first 35 are 
used. 

——p> Example « This is an example of how to change the printer’s network name an description: 
This shows how a configuration looks before using this command and after using this 
command: 

“XA 


“KNZebral,desk printer 
“XZ 


Before using this command: After using this command: 


PRINTER CONF IGURAT ION PRINTER CONFIGURATION 


Zebra Technologies 
ZTC 105SL-200dpi 
Zebral 

desk_pr inter 


Zebra Technologies 
2TC 105SL-200dpi 


aie fa(etatsl witlen ld fader iad DARKNESS 
OLB arctic eae wane a TEAR OFF 
TEAR OFF........... PRINT MODE 


NON-CONTINUOUS..... 
WEBS crt eet eee SENSOR TYPE 
THERMAL-TRANS.....- PRINT METHOD 
101 478 MM......... PRINT WIDTH 
ck eee ere LABEL LENGTH 
7.O0IN 177MM... -. MAXIMUM LENGTH 
PARALLEL..........- PARALLEL COMM. 
RS232. eee eee SERIAL COMM. MAXIMUM LENGTH 
i daban acenaasiessranean acta BAUD PARALLEL COMM. 
DATA_BITS SERTAL COMM. 
.. PARITY -. BAUD 
. HOST HANDSHA - DATA BITS 
PROTOCOL ARITY 
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Define Password 


Description The “KP command is used to define the password that must be entered to 
access the control panel switches and LCD Setup Mode. 


Format *KPa,b 


This table identifies the parameters for this format: 


Parameters Details 


a = mandatory four- | Accepted Values: any four-digit numeric sequence 
digit password —_| Default Value: 1234 


b = password level Accepted Values: 1, 2, 3, 4 
Default Value: 3 


——> Example « This is an example of how to set a new control panel password: 
“XA 
“KP5678 
“XZ 


Comments If you forget your password, the printer can be returned to a default Setup Mode 
and the default password /234 is valid again. Caution should be used, however — this also 
sets the printer configuration values back to their defaults. 


To return the printer to the default factory settings using ZPL, send this: 
“XA 
“JUF 
“XZ 


To return the printer to the default factory settings using the control panel keys, see your 
printer’s User Guide for the procedure. 
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ZPL Commands 


ALH 


“LH 


Label Home 


Description The *LH command sets the label home position. 


The default home position of a label is the upper-left corner (position 0,0 along the x and y 
axis). This is the axis reference point for labels. Any area below and to the right of this point is 
available for printing. The “LH command changes this reference point. For instance, when 
working with preprinted labels, use this command to move the reference point below the 
preprinted area. 


This command affects only fields that come after it. It is recommended to use “LH as one of 
the first commands in the label format. 


Format *LHx,y 


This table identifies the parameters for this format: 


Parameters Details 


xX = x-axis position | Accepted Values: 0 to 32000 
(in dots) Initial Value at Power-up: 0 or last permanently saved value 


y = y-axis position | Accepted Values: 0 to 32000 
(in dots) Initial Value at Power-up: 0 or last permanently saved value 


Depending on the printhead used in your printer, use one of these when figuring the values for 
x and y: 

6dots = 1mm, 152 dots = 1 inch 

8 dots = 1 mm, 203 dots = 1 inch 

11.8 dots = 1 mm, 300 dots = 1 inch 

24 dots = 1mm, 608 dots = 1 inch 


Comments To be compatible with existing printers, this command must come before the 
first “F'S (Field Separator) command. Once you have issued an “LH command, the setting is 
retained until you turn off the printer or send a new “LH command to the printer. 
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ALL 
Label Length 


Description The *LL command defines the length of the label. This command is necessary 
when using continuous media (media not divided into separate labels by gaps, spaces, notches, 
slots, or holes). 


To affect the current label and be compatible with existing printers, “LL must come before the 
first “F'S (Field Separator) command. Once you have issued “LL, the setting is retained until 
you turn off the printer or send a new “LL command. 


Format “LLy 


This table identifies the parameters for this format: 


Parameters Details 
y = y-axis position Accepted Values: 1 to 32000, not to exceed the maximum label 
(in dots) size. 


While the printer accepts any value for this parameter, the 
amount of memory installed determines the maximum length 
of the label. 
Default Value: typically set through the LCD (if applicable), or to 
the maximum label length capability of the printer. 


Comments These formulas can be used to determine the value of y: 


For 6 dot/mm printheads... Label length in inches x 152.4 (dots/inch) = y 
For 8 dot/mm printheads... Label length in inches x 203.2 (dots/inch) = y 
For 12 dot/mm printheads... Label length in inches x 304.8 (dots/inch) = y 


For 24 dot/mm printheads... Label length in inches x 609.6 (dots/inch) = y 


Values for y depend on the memory size. If the entered value for y exceeds the acceptable 
limits, the bottom of the label is cut off. The label also shifts down from top to bottom. 


If multiple “LL commands are issued in the same label format, the last *LL command affects 
the next label unless it is prior to the first “FS. 
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ALR 


“LR 


Label Reverse Print 


45541L-003 Rev. A 


Description The “LR command reverses the printing of all fields in the label format. It 
allows a field to appear as white over black or black over white. 


Using the “LR is identical to placing an “FR command in all current and subsequent fields. 


Format *LRa 


This table identifies the parameters for this format: 


Parameters 


a = reverse print all 


fields 


Details 


Accepted Values: 
N = 
Y= 


Initial Value at Power-up: N or last permanently saved value 


Example « This is an example that shows printing white over black and black over white. 
The *GB command is used to create the black background. 


ZPL Il CODE GENERATED LABEL 
“XA*LRY 
“FO100,50 LABsSa 
“GB195,203,195*FS REVE RSE 


“FO180,110*CFG 


“FDLAB 
“FO130 


, 170 


EL*EFS 


“FDREVE 


“XZ 


RS 


E“ES 


Comments The “LR setting remains active unless turned off by “LRN or the printer is 


turned off. 


Note « “GB needs to be used together with “LR. 


Only fields following this command are affected. 
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ALS 


Label Shift 
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Description The *LS command allows for compatibility with Z-130 printer formats that are 
set for less than full label width. It is used to shift all field positions to the left so the same 
commands used on a Z-130 or Z-220 Printer can be used on other Zebra printers. 


To determine the value for the “LS command, use this formula: 
Z-130 and Z-220 values for *LHx + *FOx 


(distance from edge of label) = printer value for “LSa 


If the print position is less than 0, set “LS to 0. 


Format *LSa 

Important ¢ The ability to save the *LS command depends on the version of firmware. 
This table identifies the parameters for this format: 

Details 


Accepted Values: -9999 to 9999 
Initial Value at Power-up: 0 


Parameters 


a = shift left value 
(in dots) 


Comments When entering positive values, it is not necessary to use the + sign. The value is 
assumed to be positive unless preceded by a negative sign (-). 


To be compatible with existing Zebra printers, this command must come before the first “FS 
(Field Separator) command. Once you have issued an “LS command, the setting is retained 
until you turn off the printer or send a new “LS command to the printer. 
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“Le 
Label Top 


Description The *LT command moves the entire label format a maximum of 

120 dot rows up or down from its current position, in relation to the top edge of the label. A 
negative value moves the format towards the top of the label; a positive value moves the 
format away from the top of the label. 


This command can be used to fine-tune the position of the finished label without having to 
change any of the existing parameters. 


to cause the media to backup into the printer and become unthreaded from the platen. This 


Important ¢ For some printer models, it is possible to request a negative value large enough 
condition can result in a printer error or unpredictable results. 


Format *LTx 


This table identifies the parameters for this format: 


Details 


Accepted Values: -120 to 120 


Default Value: a value must be specified or the command is 
ignored 


Parameters 


x = label top (in dot 
rows) 


Comments The Accepted Value range for x might be smaller depending on the printer 
platform. 


The “LT command does not change the media rest position. 
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Map Clear 
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Description In normal operation, the bitmap is cleared after the format has been printed. 
The “MC command is used to retain the current bitmap. This applies to current and subsequent 
labels until cleared with “MCY. 


Format *MCa 


Important « To produce a label template, *MC must be used with “FV. 


This table identifies the parameters for this format: 


Parameters Details 


Accepted Values: Y (clear bitmap) or N (do not clear bitmap) 
Initial Value at Power-up: Y 


a = map clear 


Comments The *MC command retains the image of the current label after formatting. It 
appears in the background of the next label printed. 
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SMD 


“MD 


Media Darkness 


—p> 
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Description The “MD command adjusts the darkness relative to the current darkness setting. 
Format *MDa 


This table identifies the parameters for this format: 


Parameters Details 


a = media darkness 
level 


Accepted Values: - 30 to 30, depending on current value 
Initial Value at Power-up: 0 


If no value is entered, this command is ignored. 


Example « These examples show setting the printer to different darkness levels: 


¢ Ifthe current value (value on configuration label) is 16, entering the command *“MD-9 
decreases the value to 7. 


¢ Ifthe current value (value on configuration label) is 1, entering the command “MD15 
increases the value to 16. 


¢ Ifthe current value (value on configuration label) is 25, entering the command *MD10 
increases only the value to 30, which is the maximum value allowed. 


Each “MD command is treated separately in relation to the current value as printed on the 
configuration label. 


Important ¢ The darkness setting range for the XiIILP/us is 0 to 30 in increments of 0.1. 
The firmware is setup so that the “MD and ~SD commands (ZPL darkness commands) 
accepts that range of settings. 


Example « These are examples of the X7II[P/us Darkness Setting: 
“MD8.3 


~SD8.3 


Example « For example, this is what would happen if two “MD commands were received: 


Assume the current value is 15. An *MD-6 command is received that changes the 


current value to 9. Another command, “MD2, is received. The current value changes to 
17. 


The two “MD commands are treated individually in relation to the current value of 15. 


Comments The ~SD command value, if applicable, is added to the *MD command. 
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ZPL Commands 
AMF 


Description The “MF command dictates what happens to the media at power-up and at 
head-close after the error clears. 


Format *MFp,h 


This table identifies the parameters for this format: 


Parameters 


p = feed action at 
power-up 


Details 


Accepted Values: 
F = feed to the first web after sensor 
C = (see ~JC on page 190 definition) 
L = (see ~JZ on page 197 definition) 
N = no media feed 

Default Value: platform-dependent 


h = feed action after 
closing printhead 


Accepted Values: 
F = feed to the first web after sensor 
Cc 
L 
N = no media feed 

Default Value: platform-dependent 


(see ~JC on page 190 definition) 
(see ~JL on page 197 definition) 


Comments It is important to remember that if you choose the N setting, the printer assumes 
that the media and its position relative to the printhead are the same as before power was 
turned off or the printhead was opened. Use the “JU command to save changes. 


ZPL Il Programming Guide For x.10 through x.13 Firmware 


45541L-003 Rev. A 


223 


224 | 
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AML 


“ML 


Maximum Label Length 


Description The “ML command lets you adjust the maximum label length. 


Format *MLa,b,c,d 


This table identifies the parameters for this format: 


Parameters Details 


a = maximum label | Accepted Values: 0 to maximum length of label 
length (in dot 


rows) 


Default Value: last permanently saved value 


Comments For calibration to work properly, you must set the maximum label length equal 


to or greater than your actual label length. 
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“MM 
Print Mode 


Description The *MM command determines the action the printer takes after a label or 
group of labels has printed. 


Format *MMa,b 


This table identifies the parameters for this format: 


Parameters Details 
a = desired mode Accepted Values: 
T = Tear-off 


P = Peel-off (not available on S-300) 
= Rewind (depends on printer model) 
Applicator (depends on printer model) 


QP, wn 
Il 


= Cutter (depends on printer model) 


D = Delayed cutter 
Default Value: T 


The values available for parameter a are dependent on the 
printer being used and whether it supports the option. 


b = prepeel select Accepted Values: 
N = no 
Y = yes 
Default Value: Y 


The command is ignored if parameters are missing or invalid. 
The current value of the command remains unchanged. 


This bulleted list identifies the different modes of operation: 


¢ Tear-off — after printing, the label advances so the web is over the tear bar. The label, 
with liner attached, can be torn off manually. 


¢ Peel-off — after printing, the label moves forward and activates a Label Available Sensor. 
Printing stops until the label is manually removed from the printer. 


Power Peel — liner automatically rewinds using an optional internal rewind spindle. 
Value Peel — liner feeds down the front of the printer and is manually removed. 


Prepeel — after each label is manually removed, the printer feeds the next label forward to 
prepeel a small portion of the label away from the liner material. The printer then 
backfeeds and prints the label. The prepeel feature assists in the proper peel operation of 
some media types. 
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SMM 


¢ Rewind — the label and backing are rewound on an (optional) external rewind device. 
The next label is positioned under the printhead (no backfeed motion). 


¢ Applicator — when used with an application device, the label move far enough forward to 
be removed by the applicator and applied to an item. 


¢ Cutter — after printing, the media feeds forward and is automatically cut into 
predetermined lengths. 


Comments Be sure to select the appropriate value for the print mode being used to avoid 
unexpected results. 
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“MN 
Media Tracking 


Description The *MN command relays to the printer what type of media is being used 
(continuous or non-continuous) for purposes of tracking. This bulleted list shows the types of 
media associated with this command: 


* Continuous Media — this media has no physical characteristic (web, notch, perforation, 
mark, et cetera) to separate labels. Label length is determined by the *LL command. 


¢ Non-continuous Media — this media has some type of physical characteristic (web, notch, 


perforation, mark, et cetera) to separate the labels. 


Format *MNa 


This table identifies the parameters for this format: 


Parameters Details 


a = media being used | Accepted Values: 

N = continuous media 
Y 
W 
M = non-continuous media mark sensing 


non-continuous media web sensing * 


non-continuous media web sensing * 


Default Value: a value must be entered or the command is ignored 


* provides the same result. 
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ZPL Commands 
AMP 


“MP 


Mode Protection 


Description The “MP command is used to disable the various mode functions on the control 
panel. Once disabled, the settings for the particular mode function can no longer be changed 
and the LED associated with the function does not light. 


Because this command has only one parameter, each mode must be disabled with an individual 


“MP command. 


Format *MPa 


This table identifies the parameters for this format: 


Parameters 


a = mode to protect 


Details 


Accepted Values: 

D = disable Darkness Mode 
P = disable Position Mode 

C = disable Calibration Mode 
E 
5 


= enable all modes 


= disable all mode saves (modes can be adjusted but 
values are not saved) 


W = disable Pause 
F = disable Feed 
X = disable Cancel 
M = disable menu changes 
Default Value: a value must be entered or the command is ignored 


=> Example « This example disables these modes, D and C. 


“XA 
“MPD 
“MPC 
“XZ 
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A 
MT 
Media Type 
Description The “MT command selects the type of media being used in the printer. There 


are two choices for this command: 


¢ Thermal Transfer Media — this media uses a high-carbon black or colored ribbon. The 
ink on the ribbon is bonded to the media. 


¢ Direct Thermal Media — this media is heat sensitive and requires no ribbon. 


Format *MTa 


This table identifies the parameters for this format: 


Parameters Details 


a = mediatype used | Accepted Values: 
T = thermal transfer media 
D = direct thermal media 
Default Value: a value must be entered or the command is ignored 


6/9/06 ZPL Il Programming Guide For x.10 through x.13 Firmware 45541L-003 Rev. A 


230 | ZPL Commands 
AMU 


“MU 


Set Units of Measurement 
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Description The “MU command sets the units of measurement the printer uses. “MU works 
on a field-by-field basis. Once the mode of units is set, it carries over from field to field until a 
new mode of units is entered. 


“MU also allows for printing at lower resolutions — 600 dpi printers are capable of printing at 
300, 200, and 150 dpi; 300 dpi printers are capable of printing at 150 dpi. 


Format *MUa,b,c 


This table identifies the parameters for this format: 


Parameters Details 
a = units Accepted Values: 
D = dots 
I = inches 
M = millimeters 


Default Value: D 
b = format base in Accepted Values: 150, 200, 300 


dots per inch Default Value: a value must be entered or the command is ignored 


= desired dots-per- | Accepted Values: 300, 600 
inch conversion | Default Value: a value must be entered or the command is ignored 


Q 
| 


Example « This is an example of Setting Units: 
Assume 8 dot/millimeter (203 dot/inch) printer. 
Field based on dots: 
“MUd* FO100,100*%GB1024,128,128°FS 
Field based on millimeters: 
“MUm*FO12.5,12.5*°GB128,16,16°FS 
Field based on inches: 
“MUL*FO.493, .493°GB5.044,.631, .631*°FS 
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—=> Example « This is an example of Converting dpi Values. 
Convert a 150 dpi format to a 300 dpi format with a base in dots: 
“MUd, 150,300 
Convert a 150 dpi format to a 600 dpi format with a base in dots: 
“MUd, 150, 600 
Convert a 200 dpi format to a 600 dpi format with a base in dots: 


“Mud, 200, 600 
To reset the conversion factor to the original format, enter matching values for 
parameters b and c: 


“MUd, 150,150 
“MUd, 200, 200 
“MUd, 300, 300 
“MUd, 600, 600 


Comments This command should appear at the beginning of the label format to be in proper 
ZPL II format. 


To turn the conversion off, enter matching values for parameter b and c. 
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“MW 
Modify Head Cold Warning 


Description The *MW command allows you to set the head cold warning indicator based on 
the operating environment. 


Format “Mwy 


This table identifies the parameters for this format: 


Details 


Parameters 


a =enable head cold | Accepted Values: 


warning y = enable head cold warning 
n = disable head cold warning 
Important * When a parameter is not given, the instruction is ignored. 
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~NC 
Network Connect 


Description The ~NC command is used to connect a particular printer to a network by 
calling up the printer’s network ID number. 


Format ~NC### 


This table identifies the parameters for this format: 


Parameters Details 


### = network ID Accepted Values: 001 to 999 
number assigned | Default Value: 000 (none) 
(must be a three- 
digit entry) 


Comments Use this command at the beginning of any label format to specify which printer 
on the network is going to be used. Once the printer is established, it continues to be used until 
it is changed by another ~NC command. This command must be included in the label format to 
wake up the printer. 


The commands “MW, ~NC, “NI, ~NR, and ~NT are used only with RS-485 printer 
communications. 
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ANI 
Network ID Number 


Description The “NI command is used to assign a network ID number to the printer. This 
must be done before the printer can be used in a network. 


Format *NI### 


This table identifies the parameters for this format: 


Parameters Details 


### = network ID Accepted Values: 001 to 999 
number assigned | Default Value: 000 (none) 
(must be a three- 
digit entry) 


Comments The last network ID number set is the one recognized by the system. 


The commands ~NC, “NI, ~NR, and ~NT are used only with RS-485 printer 
communications. 
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~NR 
Set All Network Printers Transparent 


Description The ~NR command sets all printers in the network to be transparent, regardless 
of ID or current mode. 


Format ~NR 


Comments The commands ~NC, “NI, ~NR, and ~NT are used only with RS-485 printer 
communications. 
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A 
NS 
Change Networking Settings 
Description The “NS command is used to change Ethernet network settings. 


Format *NSa,b,c,d 


This table identifies the parameters for this format: 


Parameters Details 


a = network setting | Accepted Values: 
IP Resolution. 


a = all 
b = BOOTP 
c = DHCP and BOOTP 
d = DHCP 
g = gleaning only 
r = RARP 
p = permanent 
b = IP Address Accepted Values: 0 to 255 


“c= Subnet Mask =| Accepted Values:0t02550 


d = Default Gateway | Accepted Values: 0 to 255 
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~NT 
Set Currently Connected Printer Transparent 


Description The ~NT command sets the currently connected network printer to be 
transparent. 


Format ~NT 


Comments With Z Series® printers, the ~NT command functions the same as the ~NR 
command. All Z Series printers on a network receive the transmission. 


The commands ~NC, “NI, ~NR, and ~NT are used only with RS-485 printer 
communications. 
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A 
PF 
Slew Given Number of Dot Rows 
Description The “PF command causes the printer to slew labels (move labels at a high 
speed without printing) a specified number of dot rows from the bottom of the label. This 


allows faster printing when the bottom portion of a label is blank. 


Format *PF# 


This table identifies the parameters for this format: 


Details 


Accepted Values: 0 to 32000 


Parameters 


# = number of dots 
rows to slew 
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APH ~PH 
“PH ~PH 
Slew to Home Position 


Description The *PH or ~PH command causes the printer to feed one blank label. 


The ~PH command feeds one label after the format currently being printed is done or when the 
printer is placed in pause. 


The “PH command feeds one blank label after the current format prints. 


Format *PH or ~PH 
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“PM 


Printing Mirror Image of Label 
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Description The “PM command prints the entire printable area of the label as a mirror 


image. This command flips the image from left to right. 


Format *PMa 


This table identifies the parameters for this format: 


Parameters Details 
a = print mirror Accepted Values: 
image of entire N = no 
label Y = yes 
Default Value: N 


Example ¢ This is an example of printing a mirror image on a label: 


ZPL Il CODE 


GENERATED LABEL 


“XA* PMY 
“FO100,100 
“CFG 
“FDMIRROR“*FS 
“FO100,160 
“FDIMAGE*FS 
“XZ 


AQAA | M 
ADAM | 


Comments If the parameter is missing or invalid, the command is ignored. Once entered, 


the “PM command remains active until “PMN is received or the printer is turned off. 
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Description The “PO command inverts the label format 180 degrees. The label appears to 
be printed upside down. If the original label contains commands such as “LL, “LS, “LT and 


“PF, the inverted label output is affected differently. 


Format *P0a 


This table identifies the parameters for this format: 


Parameters 


a = invert label 


Details 


Accepted Values: N (normal) or I (invert) 


180 degrees Default Value: N 
——— Example « This is an example of printing a label at 180 degrees: 
ZPL Il CODE GENERATED LABEL 
“XA*CFD 
POL 
“LH330,10 
“FO50,50 
“FDZEBRA TECHNOLOGIES“’FS 
“FO50,75 
% ij . A TI ‘STTTH WOU”, 
ee S3ISOTONHOAL ¥aaaZ 


The “POI command inverts the x, y coordinates. All image placement is relative to these 
inverted coordinates. Therefore, a different “LH (Label Home) can be used to move the print 


back onto the label. 


Comments If multiple *PO commands are issued in the same label format, only the last 
command sent to the printer is used. 


Once the *PO command is sent, the setting is retained until another “PO command is received 


or the printer is turned off. 
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“PP ~PP 
Programmable Pause 


Description The ~PP command stops printing after the current label is complete (if one is 
printing) and places the printer in Pause Mode. 


The *PP command is not immediate. Therefore, several labels might print before a pause is 
performed. This command pauses the printer after the current format prints. 


The operation is identical to pressing PAUSE on the control panel of the printer. The printer 
remains paused until PAUSE is pressed or a ~PS (Print Start) command is sent to the printer. 


Format *PP or ~PP 
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Print Quantity 


Description The *PQ command gives control over several printing operations. It controls 
the number of labels to print, the number of labels printed before printer pauses, and the 
number of replications of each serial number. 


Format *PQq,p,r,0 


This table identifies the parameters for this format: 


Parameters Details 
q = total quantity of | Accepted Value: 1 to 99,999,999 
labels to print Default Value: 1 


pause and cut Accepted Value: 1 to 99, 999,999 


value (labels Default Value: 0 (no pause) 
between pauses) 


O 
ll 


r = replicates ofeach | Accepted Value: 0 to 99, 999, 999 replicates 
serial number Default Value: 0 (no replicates) 


oO = override pause Accepted Values: 
count N = no 
Y = yes 
Default Value: N 


If the o parameter is set to Y, the printer cuts but does not pause, and the printer does not pause 
after every group count of labels has been printed. With the o parameter set to N (default), the 
printer pauses after every group count of labels has been printed. 


——— Example « This example shows the control over print operations: 


“PQ50,10,1,¥Y: This example prints a total of 50 labels with one replicate of each serial 
number. It prints the total quantity in groups of 10, but does not pause after every group. 


“PQ50,10,1,N: This example prints a total of 50 labels with one replicate of each serial 
number. It prints the total quantity in groups of 10, pausing after every group. 
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“APR 
Print Rate 


Description The “PR command determines the media and slew speed (feeding a blank 
label) during printing. 


The printer operates with the selected speeds until the setting is reissued or the printer is turned 
off. 


The print speed is application-specific. Because print quality is affected by media, ribbon, 
printing speeds, and printer operating modes, it is very important to run tests for your 
applications. 


Important * Some models go to default print speed when power is turned off. 


Format *PRp,s,b 


This table identifies the parameters for this format: 


Parameters Details 


p = print speed Accepted Values: 

Aor2 = 50.8 mm/sec. (2 inches/sec.) 
Bor3 = 76.2 mm/sec. (3 inches/sec.) 
Cor4 = 101.6 mm/sec. (4 inches/sec.) 
5 = 127 mm/sec.(5 inches/sec.) 

Dor 6 = 152.4 mm/sec. (6 inches/sec.) 
E or 8 = 203.2 mm/sec. (8 inches/sec.) 
9 = 220.5 mm/sec. 9 inches/sec.) 

10 = 245 mm/sec.(10 inches/sec.) 

14. 269.5 mm/sec.(11 inches/sec.) 


12 = 304.8 mm/sec. 12 inches/sec.) 
Default Value: A 
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Parameters Details 


s = slew speed Accepted Values: 

Aor2 = 50.8 mm/sec. (2 inches/sec.) 
Bor3 = 76.2 mm/sec. (3 inches/sec.) 
Cor4 = 101.6 mm/sec. (4 inches/sec.) 
5 = 127 mm/sec. 5 inches/sec.) 

Dor6 = 152.4 mm/sec. (6 inches/sec.) 
E or 8 203.2 mm/sec. (8 inches/sec.) 
9 = 220.5 mm/sec. (9 inches/sec.) 

10 = 245 mm/sec. (10 inches/sec.) 

11 = 269.5 mm/sec. 11 inches/sec.) 


12 = 304.8 mm/sec. 12 inches/sec.) 
Default Value: D 


b = backfeed speed | Accepted Values: 

Aor2 = 50.8 mm/sec. (2 inches/sec.) 
Bor3 = 76.2 mm/sec. (3 inches/sec.) 
Cor4 = 101.6 mm/sec. (4 inches/sec.) 
5 = 127 mm/sec.(5 inches/sec.) 

Dor 6 = 152.4 mm/sec. (6 inches/sec.) 
E or 8 = 203.2 mm/sec. (8 inches/sec.) 
9 = 220.5 mm/sec. 9 inches/sec.) 

10 = 245 mm/sec. 10 inches/sec.) 

11 = 269.5 mm/sec. 11 inches/sec.) 


12 = 304.8 mm/sec. 12 inches/sec.) 
Default Value: A 


Comments The speed setting for p, s, and b is dependent on the limitations of the printer. If 
a particular printer is limited to a rate of 6 ips (inches per second), a value of 12 can be entered 
but the printer performs only at a 6 ips rate. See your printer’s User Guide for specifics on 
performance. 
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~PR 
Applicator Reprint 
Description The ~PR command is supported only by the P4X and P4X2-Series printers. If 
the ~PR command is enabled (see “// on page 195), the last label printed reprint, similar to the 
applicator asserting the Reprint signal on the applicator port. 


Format ~PR 


Comments Pressing PREVIOUS on the control panel also causes the last label to reprint. 
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~PS 
Print Start 
Description The ~PS command causes a printer in Pause Mode to resume printing. The 
operation is identical to pressing PAUSE on the control panel of the printer when the printer is 


already in Pause Mode. 


Format ~PsS 
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APW 
Print Width 


Description The “PW command allows you set the print width. 


Format *PWa 


This table identifies the parameters for this format: 


Parameters Details 


a = label width (in Accepted Values: 2, to the width of the label 


dots) If the value exceeds the width of the label, the width is set to 
the label’s maximum size. 


Default Value: last permanently saved value 


Limitation Not all Zebra printers support the “PW command. 
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~RO 


Description The ~RO command resets the advanced counters used by the printer to monitor 
label generation in inches, centimeters, and number of labels. Two resettable counters are 


available and can be reset. 


Format ~ROc 


This table identifies the parameters for this format: 


Parameters 


Cc = counter number 


Before 
296862 


92928 LABLS 
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Details 


Accepted Values: 1 or 2 


ignored 


Example « This is an example of the ~RO command. 


NONRESET CNTR 
RESET CNTR1 


RESET CNTR1 
RESET CNTR2 


ardeasaries NONRESET CNTR 
Sitraceuats RESET CNTR1 
ofan sa RESET CNTR2 


Default Value: a value must be specified or the command is 


PRINTER CONFIGURATION | 


Zebra Technologies 
2TC 140XiITIP1Us-200dpi 
Benny 


38.0iN’ "$8 
MEDIA DISAB 
MAINT. OFF EARLY WARNING 
PARALLEL “COMM. 
rn. 


NOT CONNECT 
PARALLEL... 
RS232.. 2. SERIAL CO 


3 
38400. BAUD 
8 BITS DATA_BITS 
NONE... 
xON/ XO! HOST HANDSHAKE 
INI PROT! 


5 es ease a NETWORK 1D 
COMMUNICATIONS 
CONTROL PREFIX 
FORMAT PREFIX 
DELIMITER CHAR 
2PL. 


HARDWARE ID 
CONFIGURATION 
RAM 

MEMORY CARD 


753289 CN... 
92928 LABLS 


LABL! 
AV12446 .04-26-2002 .33008.0D.VH1 


FIRMWARE IN THIS PRINTER IS COPYRIGHTED 
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“SC 


Set Serial Communications 


Description The *SC command allows you to change the serial communications 


parameters you are using. 


Format *SCa,b,c,d,e,f 


This table identifies the parameters for this format: 


Parameters 


a baud rate 


Details 


Accepted Values: 110; 600; 1,200; 2400; 4800; 9600; 
14400; 19200; 28800; 38400; or 57600; 115200 


Default Value: must be specified or the parameter is ignored 


b = word length (in 


Accepted Values: 7 or 8 
Default Value: must be specified 


Accepted Values: N (none), E (even), or O (odd) 
Default Value: must be specified 


data bits) 
Cc = parity 
d = stop bits 


Accepted Values: 1 or 2 
Default Value: must be specified 


€ = protocol mode 


f = Zebra protocol 


Accepted Values: 

X = XON/XOFF 

D = DTR/DSR 

R = RTS 
Default Value: must be specified 
Accepted Values: 

A = ACK/NAK 

N = none 

Z = Zebra 


Default Value: must be specified 


Comments If any of the parameters are missing, out of specification, not supported by a 
particular printer, or have a ZPL-override DIP switch set, the command is ignored. 


A “JUS command causes the changes in Communications Mode to persist through power-up 


and software resets. 
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~SD 


Description The ~SD command allows you to set the darkness of printing. ~SD is the 
equivalent of the darkness setting parameter on the control panel display. 


Format ~SD## 


This table identifies the parameters for this format: 


Parameters Details 

## = desired Accepted Values: 00 to 30 
darkness setting | Default Value: last permanently saved value 
(two-digit 
number) 

———= > Example « These are examples of the XiIILP/us Darkness Setting: 
“MD8.3 
~SD8.3 


Comments The “MD command value, if applicable, is added to the ~SD command. 
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“SE 
Select Encoding 


Description The *SE command is used to select the desired ZPL or ZPL I encoding table. 


Format *SEd:0.x 


This table identifies the parameters for this format: 


Parameters Details 

d = location of Accepted Values: R:,E:,B:,and A: 
encoding table =| Default Value: R: 

o = name of Accepted Value: 1 to 8 alphanumeric characters 
encoding table Default Value: a value must be specified 

x = extension Fixed Value: . DAT 


The encoding tables are provided with the font card or downloaded in flash with the font. The 
table appears as XXXXXXX. DAT in a directory label printed by the ZPL commands. 


The most active encoding table is indicated by the * on the directory label. 
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Serialization Field (with a Standard “FD String) 


Description The “SF command allows you to serialize a standard “FD string. The 
maximum size of the mask and increment string is 3K combined. 


Format *SFa,b 


This table identifies the parameters for this format: 


Parameters 


a = mask string 


b = increment string 


Details 


The mask string sets the serialization scheme. The length of the 
string mask defines the number of characters in the current “FD 
string to be serialized. The mask is aligned to the characters in the 
“ED string starting with the right-mostposition. 


Mask String placeholders: 

D or d— Decimal numeric 0-9 

H or h — Hexadecimal 0-9 plus a-f or A-F 

O or o — Octal 0-7 

A or a — Alphabetic A—Z or a-z 

N or n— Alphanumeric 0-9 plus A—Z or a—z 

% — Ignore character or skip 

The increment string is the value to be added to the field on each 
label. The default value is equivalent to a decimal value of one. 
The string is composed of any characters defined in the serial 


string. Invalid characters are assumed to be equal to a value of 
zero in that characters position. 


The increment value for alphabetic strings start with ‘A’ or ‘a’ as 
the zero placeholder. This means to increment an alphabetic 
character by one, a value of ‘B’ or ‘b’ must be in the increment 
string. 


For characters that do not get incremented, the 3 character needs to be added to the increment 


string. 
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ZPL Commands 


Example « This is an example of serializing a “FD string. The ZPL II code generates three 
separate labels as seen in Generated Labels: 


ZPL Il CODE GENERATED LABELS 
‘a 12K 
“FO100,100 
“CFO,100 
A SFnnA, F*FS 12F 
a7 L 
12A 


This mask has the first characters as alphanumeric (nn = 


12) and the last digit as uppercase 


alphabetic (A). The decimal value of the increment number is equivalent to 5 (F). The number 
of labels generated depends on the number specified by the “PQ command. 


In a similar instance, the “FD string could be replaced with either of the “FD strings below to 
generate a series of label, determined by “PQ. 


BLOO10,... 
BMOQOO... 


Using this ZPL code: 
“FDBLOO000*SFAAdddd, 1 

The print sequence on this series of labels is: 
BLO0OO00, BLOOO1,...BLO009, 
BLO099, BLO100,...BL9999, 

Using this ZPL code: 
“FDBLOO-O*SFAAddSd,1%1 


The print sequence on this series of labels is: 


BLOO-O, B 
BL11-0, B 


01-1, BLO2-2,...1 


BLO9-9, 


fe ee ee 
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Examples « These examples show the importance of capitalization and location within the 
mask. 


In this example, the printer cycles with every two printed labels and alternates between H 
(position 18), and then Z (position 36). With n or N, the serial number increments from 0 - 9 
and a—z or A—Z (36 positions overall). With each completed cycle, the second cluster (nn) 
increments one position (from 00, 01, 02 ...) per cycle: 


ZPL Il CODE GENERATED LABELS 


“XA 
“FO100, 50*A0N,50,50*°FDzzZ*SFnnN, I*FS 04H 
“PQ10 
AXZ _ 032 


In this example, lower case i increments with a mask string of nnN. Nothing changes because 
the first cluster (Z) never triggers the second cluster (zz) to change. 


ZPL Il CODE GENERATED LABELS 


AXA 
“FO100, 50*AON, 50,50*°FDzzZ*SFnnN, i*FS uz 


“PQ10 = 
AXZ, zz 
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ASL 
Set Mode and Language (for Real-Time Clock) 


Description The “SL command is used to specify the Real-Time Clock’s mode of operation 
and language for printing information. 


Important « 
* Time is read when the image is created. If the image stays in the queue longer than the 
specified time the image will be recreated with a new time. 
¢ There are incidents when the same time or a larger space of time may be printed on labels. 
This is due to the format complexity and print speed. 


Format *SLa,b 


This table identifies the parameters for this format: 


Parameters Details 


a = mode Accepted Values: 


S = Start Time Mode. This is the time that is read from the 
Real-Time Clock when label formatting begins (when 
“XA is received). The first label has the same time 
placed on it as the last label. 

T = Time Now Mode. This is the time that is read from the 
Real-Time Clock when the label to be printed is placed 
in print queue. Time Now is similar to a serialized time 
or date field. 

Numeric Value = With the Enhanced Real Time Clock 
(V60.13.0.10 and above) a time accuracy tolerance can 
be specified. Range = 1 to 999 seconds, 0 = one second 
tolerance 


Example: SL30,1 = Accuracy tolerance of 30 seconds and 
use English. 
Default Value: S 
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Parameters Details 

b = language Accepted Values: 
1 = English 
Spanish 


NO 
ll 


= French 

= German 

= Italian 
Norwegian 
= Portuguese 
= Swedish 
= Danish 
10 = Spanish 2 
Dutch 
Finnish 


- OO OANA OB W 
ll 


— 
i 
Il 


hb 
i) 
Il 


Default Value: the language selected with “KL or the control 
panel 


Comments These are some comments to be aware of: 

¢ The “SL command must be placed before the first “FO command. 

¢ As of V60.13.0.10 all supported printers have Enhanced Real Time Clock capabilities the 
RTC will not print time fields that are more than sixty seconds old, rather it will update the 
time prior to printing (“SLT or *SL60). To control time with increments other than sixty 
seconds the “SL command can be used with a numeric value (*SL30). 
“SLS can keep times longer than sixty seconds. 
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Serialization Data 
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Description The *SN command allows the printer to index data fields by a selected 
increment or decrement value, making the data fields increase or decrease by a specified value 
each time a label is printed. This can be performed on 100 to 150 fields in a given format and 
can be performed on both alphanumeric and bar code fields. A maximum of 12 of the right- 
most integers are subject to indexing. The first integer found when scanning from right to left 
starts the indexing portion of the data field. 


If the alphanumeric field to be indexed ends with an alpha character, the data is scanned, 
character by character, from right to left until a numeric character is encountered. Serialization 
takes place using the value of the first number found. 


Format *SNv,n,z 


This table identifies the parameters for this format: 


Parameters Details 
v = starting value Accepted Values: 12-digits maximum for the portion to be indexed 


Default Value: 1 


n = increment or Accepted Values: 12-digit maximum 
decrement value | Default Value: 1 


To indicate a decrement value, precede the value with a minus 


(—) sign. 

z = add leading zeros | Accepted Values: 
(if needed) N = no 
Y = yes 


Default Value: N 


Example « This example shows incrementing by a specified value: 


ZPL Il CODE GENERATED LABELS 

. OO 1 

XA 
“F0260,110 
CEG 
“SNO01,1,¥*FS OO? 
APQ3 
“XZ 


003 


Note: The ZPL I code above will generate 
three separate labels, seen to the right. 
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Comments Incrementing and decrementing takes place for each serial-numbered field when 
all replicates for each serial number have been printed, as specified in parameter r of the *PQ 
(print quality) command. 


If, during the course of printing serialized labels, the printer runs out of either paper or ribbon, 
the first label printed (after the media or ribbon has been replaced and calibration completed) 

has the same serial number as the partial label printed before the out condition occurred. This 
is done in case the last label before the out condition did not fully print. This is controlled by 

the *JZ command. 


Using Leading Zeros 


In the “SN command, the z parameter determines if leading zeros are printed or suppressed. 
Depending on which value is used (Y = print leading zeros; N = do not print leading zeros), 
the printer either prints or suppresses the leading zeros. 


The default value for this parameter is N (do not print leading zeros). 


Print Leading Zeros 


The starting value consists of the right-most consecutive sequence of digits. The width 
(number of digits in the sequence) is determined by scanning from right to left until the first 
non-digit (space or alpha character) is encountered. To create a specific width, manually place 
leading zeros as necessary. 


Suppressing Leading Zeros 


The starting value consists of the right-most consecutive sequence of digits, including any 
leading spaces. The width (number of digits in the sequence) is determined by scanning from 
right to left until the first alpha character (except a space) is encountered. To create a specific 
width, manually place leading spaces or zeros as necessary. Suppressed zeros are replaced by 
spaces. During the serialization process, when the entire number contains all zeros, the last 
zero is not suppressed. 


The “SN command replaces the Field Data (*FD) command within a label formatting 
program. 


6/9/06 ZPL II Programming Guide For x.10 through x.13 Firmware 45541L-003 Rev. A 


260 | ZPL Commands 
‘SO 


gt @ 
Set Offset (for Real-Time Clock) 


Description The *“SO command is used to set the secondary and the tertiary offset from the 
primary Real-Time Clock. 


Note « For each label only one SO2 command can be used. If more than one offset is 
vA required, SO3 must be used. 


Format *SOa,b,c,d,e,f,9g 


This table identifies the parameters for this format: 


Parameters Details 

a = clock set Accepted Values: 
2 = secondary 
3 = third 


Default Value: value must be specified 


b = months offset Accepted Values: -32000 to 32000 
Default Value: 0 


c = days offset Accepted Values: -32000 to 32000 
Default Value: 0 

d = years offset Accepted Values: -32000 to 32000 
Default Value: 0 

e = hours offset Accepted Values: -32000 to 32000 


Default Value: 0 
f = minutes offset Accepted Values: -32000 to 32000 
Default Value: 0 
g = seconds offset Accepted Values: -32000 to 32000 
Default Value: 0 
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Start Print 
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Description The *SP command allows a label to start printing at a specified point before 
the entire label has been completely formatted. On extremely complex labels, this command 
can increase the overall throughput of the print. 


The command works as follows: Specify the dot row at which the *SP command is to begin. 
This creates a label segment. Once the *SP command is processed, all information in that 
segment prints. During the printing process, all of the commands after the “SP continue to be 
received and processed by the printer. 


If the segment after the “SP command (or the remainder of the label) is ready for printing, 
media motion does not stop. If the next segment is not ready, the printer stops mid-label and 
wait for the next segment to be completed. Precise positioning of the “SP command requires a 
trial-and-error process, as it depends primarily on print speed and label complexity. 


The “SP command can be effectively used to determine the worst possible print quality. You 
can determine whether using the *SP command is appropriate for the particular application by 
using this procedure. 


If you send the label format up to the first “SP command and then wait for printing to stop 
before sending the next segment, the printed label is a sample of the worst possible print 
quality. It drops any field that is out of order. 


If the procedure above is used, the end of the label format must be: 
“SP#*EFS 


Format *SPa 


This table identifies the parameters for this format: 


Details 


Accepted Values: 0 to 32000 
Default Value: 0 


Parameters 


a = dot row to start 
printing 


261 
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——»> Example « In this example, a label 800 dot rows in length uses *“SP500. Segment 1| prints 
while commands in Segment 2 are being received and formatted. 


fo - ~ Dot position 0 


/ 


Label Segment 2 


Dot position 500 


Label Segment 1 


Vins. / Dot position 800 
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Halt ZebraNet Alert 


Description The *SQ command is used to stop the ZebraNet Alert option. 
Format *SQa,b,c 


This table identifies the parameters for this format: 


Parameters Details 


a = condition type Accepted Values: 

A = paper out 

= ribbon out 

= printhead over-temp 

= printhead under-temp 

head open 

= power supply over-temp 

= ribbon-in warning (Direct Thermal Mode) 
= rewind full 

= cut error 


zTQ 7 AV0UaA Ww 
ll 


= printer paused 
= PQ job completed 
= label ready 

= head element out 
= reserved 

= reserved 

power on 

= clean printhead 
= media low 

= ribbon low 

= replace head 

= battery low 


<a GHunwDwDO ND OZSB HAN GH 
ll 


= all errors 
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Parameters Details 
b = destination Accepted Values: 

A = serial port 

B = parallel port 

C = e-mail address 

D = TCP/IP 

E = UDP/IP 

F = SNMP trap 

* = wild card to stop alerts for all destinations 
c = halt messages Accepted Values: 


Y = halt messages 
N = start messages 
Default Value: Y 
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Set Printhead Resistance 
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Description The *SR command allows you to set the printhead resistance. 


Format *SR#### 


This table identifies the parameters for this format: 


Parameters Details 


Accepted Value: 0488 to 1175 
Default Value: last permanently saved value 


#### = resistance 
value (four-digit 
numeric value) 


Comments To avoid damaging the printhead, this value should be less than or equal to the 
value shown on the printhead being used. Setting a higher value could damage the printhead. 


Note « New printer models automatically set head resistance. 
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“SS 
Set Media 


Sensors 


Description The *SS command is used to change the values for media, web, ribbon, and 
label length set during the media calibration process. The media calibration process is 
described in your specific printer’s user’s guide. 


Format *SSw,m,r,1,m2,r2,a,b,c 


This table identifies the parameters for this format: 


Parameters 


w= 


web (three-digit 
value) 


Details 


Accepted Values: 000 to 100 


Default Value: value shown on the media sensor profile or 
configuration label 


m = media (three- Accepted Values: 000 to 100 

digit value) Default Value: value shown on the media sensor profile or 
configuration label 

x = ribbon (three- Accepted Values: 000 to 100 

digit value) Default Value: value shown on the media sensor profile or 
configuration label 

1 = labellength (in | Accepted Values: 0001 to 32000 
dots, four-digit — | Default Value: value calculated in the calibration process 
value) 

m2 = intensity of Accepted Values: 000 to 100 
media LED Default Value: value calculated in the calibration process 
(three-digit 
value) 

r2 = intensity of Accepted Values: 000 to 100 
ribbon LED Default Value: value calculated in the calibration process 
(three-digit 
value) 

a = mark sensing Accepted Values: 000 to 100 
(three-digit Default Value: value calculated in the calibration process 
value) 

b = mark media Accepted Values: 000 to 100 
sensing (three- Default Value: value calculated in the calibration process 
digit value) 

c = mark LED Accepted Values: 000 to 100 
sensing (three- Default Value: value calculated in the calibration process 
digit value) 
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—=p> Example ¢ Below is an example of a media sensor profile. Notice the numbers from 000 to 
100 and where the words WEB, MEDIA, and RIBBON appear in relation to those numbers. 
Also notice the black vertical spike. This represents where the printer sensed the transition 
from media-to-web-to-media. 


MEDIA MEDIA MEDIA MEDIA MEDIA 


The media and sensor profiles produced vary in appearance from printer to printer. 


Comments The m2 and r2 parameters have no effect in Stripe® S-300 and S-500 printers. 


Maximum values for parameters depend on which printer platform is being used. 
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Set Date and Time (for Real-Time Clock) 
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Description The *ST command sets the date and time of the Real-Time Clock. 


Format *STa,b,c,d,e,f,g 


This table identifies the parameters for this format: 


Parameters 


a = month 


Details 


Accepted Values: 01 to 12 
Default Value: current month 


b = day Accepted Values: 01 to 31 
Default Value: current day 

c = year Accepted Values: 1998 to 2097 
Default Value: current year 

da = hour Accepted Values: 00 to 23 


Default Value: current hour 


e = minute 


Accepted Values: 00 to 59 


Default Value: current minute 


£ = second 


Accepted Values: 00 to 59 
Default Value: current second 


g = format 
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Accepted Values: 
A = am. 
P = p.m. 


M = 24-hour military 
Default Value: M 
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ASX 
Set ZebraNet Alert 


ZPL Commands 
ASX 


Description The *SX command is used to configure the ZebraNet Alert System. 


Format *SXa,b,c,d,e,f 


This table identifies the parameters for this format: 


Note ¢ The values in this table apply to firmware V48_12 4 and above. 


Parameters 


a = condition type 
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Details 


Accepted Values: 
A = paper out 
= ribbon out 
= printhead over-temp 
= printhead under-temp 
head open 
= power supply over-temp 
= ribbon-in warning (Direct Thermal Mode) 
= rewind full 
= cut error 


zQ 7 fF0QwD 
ll 


= printer paused 
= PQ job completed 
= label ready 

= head element out 
= reserved 
reserved 

= power on 

= clean printhead 
= media low 

= ribbon low 

= replace head 


GHunD OVO BK PNR GH 
ll 


= battery low 
V = allerrors 


Default Value: if the parameter is missing or invalid, the command 
is ignored 
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Parameters 


b = destination for 


Details 


Accepted Values: 


route alert A = serial port 
B* = parallel port 
C = e-mail address 
D = TCP/IP 
E = UDP/IP 
F = SNMP trap 
Default Value: if this parameter is missing or invalid, the 
command is ignored 
* Requires bidirectional communication. 
c = enable condition | Accepted Values: 
set alert to this N = no 
destination Y = yes 


d = enable condition 


Default Value: Y or previously configured value 


Accepted Values: 


clear alert to this N = no 
destination Y = yes 
Default Value: N or previously configured value 
Parameters e and f are sub-options based on destination. If the 
sub-options are missing or invalid, these parameters are ignored. 
e = destination Accepted Values: 
setting Internet e-mail address (e.g. user@company.com) 
IP address (for example, 10.1.2.123) 
SNMP trap 
IP or IPX addresses 
f£ = port number Accepted Values: 


TCP port # (0 to 65535) 
UPD port # (0 to 65535) 


Example « This is an example of the different (b) destinations that you can send for the 


condition type (a): 
Serial: “SXA,A,Y,Y 
Parallel: “SXA,B,Y,Y 
E-Mail: *SXA,C, Y, Y, admin@company.com 
TCP: *SXA,D,Y,Y,123.45.67.89,1234 
UDP: *SXA,E,Y,Y,123.45.67.89,1234 
SNMP Trap: “SXA, F,Y,Y,255.255.255.255 


Comments In the example above for SNMP Trap, entering 255.255.255.255 broadcasts the 
notification to every SNMP manager on the network. To route the device to a single SNMP 


manager, enter a specific address (123.45.67.89). 
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“SZ 
Set ZPL 


ZPL Commands 
ASZ 


Description The *SZ command is used to select the programming language used by the 
printer. This command gives you the ability to print labels formatted in both ZPL and ZPL II. 


This command remains active until another *“SZ command is sent to the printer or the printer 


is turned off. 


Format *SZa 


This table identifies the parameters for this format: 


Parameters 


a = ZPL version 


Details 

Accepted Values: 
1 = ZPL 
2 = ZPLII 


Default Value: 2 


Comments Ifthe parameter is missing or invalid, the command is ignored. 
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~TA 


Tear-off Adjust Position 


Description The ~TA command lets you adjust the rest position of the media after a label is 


printed, which changes the position at which the label is torn or cut. 


Format ~TA### 


Important * These are some important facts about this command: 


* For 600 dpi printers, the step size doubles. 


« Ifthe number of characters is less than 3, the command is ignored. 


This table identifies the parameters for this format: 


Parameters Details 

### = change in Accepted Values: -120 to 120 
media rest Default Value: last permanent value saved 
position 


(3-digit value in 
dot rows must be 
used.) 


Comments Ifthe parameter is missing or invalid, the command is ignored. 
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Description The “TO command is used to copy an object or group of objects from one 
storage device to another. It is similar to the copy function used in PCs. 


Source and destination devices must be supplied and must be different and valid for the action 
specified. Invalid parameters cause the command to be ignored. 


The asterisk (*) can be used as a wild card for object names and extensions. For instance, 
ZEBRA. * or *. GRF are acceptable forms for use with the “TO command. 


At least one source parameter (d, 0, or x) and one destination parameter (s, 0, or x) must be 
specified. If only * TO is entered, the command is ignored. 


Format *TOs:0.x,d:0.x 


This table identifies the parameters for this format: 


Parameters Details 


Ss = source device of | Accepted Values: R:,E:,B:,and A: 


stored object Default Value: if a drive is not specified, all objects are transferred 
to the drive set in parameter s 


o = stored object Accepted Values: any existing object conforming to Zebra 
name conventions 

Default Value: 1f a name is not specified, * is used — all objects 

are selected 


x = extension Accepted Values: any extension conforming to Zebra conventions 


Default Value: if an extension is not specified, * is used — all 
extensions are selected 


d = destination Accepted Values: R:,E:,B:,and A: 
device of the Default Value: a destination must be specified 
stored object 
o = name of the Accepted Values: up to 8 alphanumeric characters 
object at Default Value: if a name is not specified, the name of the existing 
destination object is used 
x = extension Accepted Values: any extension conforming to Zebra conventions 


Default Value: if an extension is not specified, the extension of the 
existing object is used 


Comments Parameters o, x, and s support the use of the wild card (*). 


If the destination device does not have enough free space to store the object being copied, the 
command is canceled. 


Zebra files (Z : * . *) cannot be transferred. These files are copyrighted by 
Zebra Technologies. 
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Transferring Objects 


These are some examples of using the “TO command. 


Example « To copy the object ZLOGO.GRF from DRAM to an optional Memory Card 
and rename it ZLOGO1 . GRF,, write the following format: 


“XA 
“TOR: ZLOGO.GRF,B: ZLOGO1.GRF 
“XZ 


Example ¢ To copy the object SAMPLE . GRF from an optional Memory Card to DRAM 
and keep the same name, write this format: 


AXA 
“TOB: SAMPLE.GRF,R:SAMPLE.GRF 
“XZ 


Transferring Multiple Objects 
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The asterisk (*) can be used to transfer multiple object files (except * . FNT) from DRAM to 
the Memory Card. For example, assume you have several object files that contain logos. These 
files are named LOGO1.GRF, LOGO2.GRF, and LOGO3. GRF. 


To transfer all these files to the memory card using the name NEW instead of LOGO, place an 
asterisk after the names NEW and LOGO in the transfer command. This copies all files 
beginning with LOGO in one command. 


“XA 
“TOR: LOGO*.GRF,B: NEW* .GRE 
“XZ 


During a multiple transfer, if a file is too big to be stored on the memory card, that file is 
skipped. All remaining files attempt to be transferred. All files that can be stored within the 
space limitations are transferred, while other files are ignored. 
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~WC 


Description The ~WC command is used to generate a printer configuration label. The printer 
configuration label contains information about the printer setup, such as sensor type, network 
ID, ZPL mode, firmware version, and descriptive data on the R:, E:,B:,and A: devices. 


Comments This command works only when the printer is idle. 


PRINTER CONFIGURATION 


Zebra_Technologies 
2Tc i7exilT1-200dpi 


B16. 003 .004.148.... 
255.255.255.000.... 
916.003.004.001. 


2000-03-23 15:21:53 


DARKNESS 
TEAR_OFF 
PRINT MODE 


BAUD 

DATA _BITS 

PARITY 

STOP BITS 

HOST HANDSHAKE 

PROTOCOL 

NETHORK ID 

COMMUNICATIONS 
Ix 

er TER CHAR 


PL 
MEDIA POWER UP 
HEAD CLOSE 


APPLICATOR oRORT 


HEDIA 
RIBBON — 

MARK S. 
MARK MED S. 

MEDIA LED 
RIBBON LED 
MARK LED 
LCD ADJUST 
MODES ENABLED 
MODES DISABLED 
RESOLUTION 
SOCKET 1 ID 
FIRMWARE 
HARDWARE ID 
CONFIGURATION 
RAM 
MEMORY CARD 


E 
TWINAX/COAX ID 
8 > BRoTGee 


IP ADDRESS 
SUBNET MASK 


. DEFAULT GATEWAY 


TIME STAMP 


FIRMWARE IN THIS PRINTER IS COPYRIGHTED 
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AWD 
Print Directory Label 


Description The “WD command is used to print a label listing bar codes, objects stored in 
DRAM, or fonts. 


For bar codes, the list shows the name of the bar code. For fonts, the list shows the name of the 
font, the number to use with “A command, and size. For objects stored in DRAM, the list 
shows the name of the object, extension, size, and option flags. All lists are enclosed in a 
double-line box. 


Format ~WDd:o0.x 


This table identifies the parameters for this format: 


Parameters Details 
d = source device — | Accepted Values:R:,E:,B:, A: andZ: 
optional Default Value: R: 
© = objectname— __ | Accepted Values: 1 to 8 alphanumeric characters 
optional Default Value: * 
The use of a ? (question mark) is also allowed. 
x = extension — Accepted Values: any extension conforming to Zebra conventions 
optional .FNT = font 
.BAR = barcode 
.ZPL = stored ZPL format 
.GREF = GRF graphic 
.CO = memory cache 
.DAT = font encoding 
.STO = data storage 
.PNG = PNG graphic 
* = all objects 
Default Value: * 
The use of a ? (question mark) is also allowed. 
—>> Example « To print a label listing all objects in DRAM, enter: 
“XA 
“WDR: *.* 
“XZ 
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=—=pP> Example « To print a label listing all resident bar codes, enter: 
“XA 


“WDZ:*.BAR 
“XZ 


=p Example « To print a label listing all resident fonts, enter: 
“XA 
“WDZ:* .FNT 
“XZ 
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AXA 
Start Format 
Description The *XA command is used at the beginning of ZPL II code. It is the opening 
bracket and indicates the start of a new label format. This command is substituted with a single 


ASCH control character STX (control-B, hexadecimal 02). 


Format *XA 


Comments Valid ZPL II format requires that label formats should start with the *XA 
command and end with the *XZ command. 
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“XB 
Suppress Backfeed 


Description The *XB command suppresses forward feed of media to tear-off position 
depending on the current printer mode. Because no forward feed occurs, a backfeed before 
printing of the next label is not necessary; this improves throughput. When printing a batch of 
labels, the last label should not contain this command. 


Format *XB 


“XB. in the Tear-off Mode 


Normal Operation: backfeed, print, and feed to rest 


“XB Operation: print (Rewind Mode) 


“XB. in Peel-off Mode 


Normal Operation: backfeed, print, and feed to rest 


“XB Operation: print (Rewind Mode) 
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AXF 
Recall Format 


Description The *XF command recalls a stored format to be merged with variable data. 
There can be multiple “XF commands in one format, and they can be located anywhere within 
the code. 


When recalling a stored format and merging data using the “FN (Field Number) function, the 
calling format must contain the “FN command to merge the data properly. 


While using stored formats reduces transmission time, no formatting time is saved. The ZPL II 
format being recalled is saved as text strings that need to be formatted at print time. 


Format *XFd:0.x 


This table identifies the parameters for this format: 


Parameters Details 


d = source device of | Accepted Values: R:,E:,B:,and A: 


stored image Default Value: search priority (R:, E:,B:,and A:) 
Oo = nameofstored | Accepted Values: | to 8 alphanumeric characters 

image Default Value: if a name is not specified, UNKNOWN is used 
x = extension | Fixed Value: .Z2PL 


For a complete example of the “DF and *XF command, see “DF and “~XF — Download 
format and recall format on page 11. 


45541L-003 Rev. A ZPL Il Programming Guide For x.10 through x.13 Firmware 6/9/06 


“XG 


Recall Graphic 


6/9/06 


ZPL Commands 
AXG 


Description The *XG command is used to recall one or more graphic images for printing. 
This command is used in a label format to merge graphics, such as company logos and piece 
parts, with text data to form a complete label. 


An image can be recalled and resized as many times as needed in each format. Other images 
and data might be added to the format. 


Format *XGd:o.x,mx,my 


This table identifies the parameters for this format: 


Parameters 


d = source device of 


stored image 


o = name of stored 
image 


Details 


Accepted Values: R:,E:,B:,and A: 
Default Value: search priority (R:, E:,B:,and A:) 


Accepted Values: 1 to 8 alphanumeric characters 
Default Value: 1f a name is not specified, UNKNOWN is used 


x = extension | 


Fixed Value: .GRF 


mx = magnification 
factor on the x- 
axis 

my = magnification 
factor on the y- 
axis 


Accepted Values: 1 to 10 
Default Value: 1 


Accepted Values: 1 to 10 
Default Value: 1 


Example « This is an example of using the “XG command to recall the image 
SAMPLE.GRF from DRAM and print it in five different sizes in five different locations on 


the same label: 
“XA 


“FO100,100*XGR: 
“FO100,200*XGR: 
“FO100, 300*XGI 
“FO100, 400*XGR: 
“FO100,500*XGR: 


“XZ 


R G 
R G 
R: SAMPLE.GRF,3,3°FS 
R G 
R G 


RF,1,1°FS 
RE, 2,2" 8s 


RF, 4,4°FS 
RF,5,5*FS 
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A 
XZ 
End Format 
Description The *XZ command is the ending (closing) bracket. It indicates the end of a 
label format. When this command is received, a label prints. This command can also be issued 
as a single ASCII control character ETX (Control-C, hexadecimal 03). 


Format *xXzZ 


Comments Label formats must start with the “XA command and end with the * XZ 
command to be in valid ZPL II format. 


45541L-003 Rev. A ZPL II Programming Guide For x.10 through x.13 Firmware 6/9/06 


AZZ 


6/9/06 


Printer Sleep 


ZPL Commands 
AZZ 


Description The *ZZ command places the printer in an idle or shutdown mode. 


Format *2Zt,b 


This table identifies the parameters for this format: 


Parameters 


t = number of 
second (idle 
time) prior to 
shutdown 


Details 


Accepted Values: 0 to 999999 -—setting 0 disables automatic 
shutdown 


Default Value: last permanently saved value or 0 


b = label status at 
shutdown 


Accepted Values: 

Y = indicates to shutdown when labels are still queued 

N = indicates all labels must be printed before shutting down 
Default Value: N 


Comments The *2Z command is only valid on the PA400 and PT400 battery-powered 


printers. 
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RFID Commands 


This section contains the ZPL II commands for RFID-specific applications. 


For more information about the RFID commands, refer to the RFID Programming Guide. A 
copy is available on the User CD provided with your printer and online at 
http://www.zebra.com/manuals. 
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RFID Commands 
RFID Command Overview 


RFID Command Overview 
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In addition to reading or encoding RFID tags, the RFID ZPL commands also provide for RFID 
exception handling, such as setting the number of read/write retries before declaring a 
transponder defective (set with “RR, “RT, and “WT) or setting the number of labels that will 
be attempted if an error occurs (set with “RS). 


For example, if an RFID label fails to program correctly or if the transponder cannot be 
detected, the printer ejects the label and prints VOID across it. The printer will try to print 
another label with the same data and format for the number of RFID labels specified by the 
“RS command. If the problem persists, the printer follows the error handling instructions 
specified by the “RS command: the printer may remove the problematic format from the print 
queue and proceed with the next format (if one exists in the buffer), or it may place the printer 
in Pause or Error mode. 


Important ¢ Consider the following before using any command in this section: 


¢ Each command lists the printers that support it. Before using a particular command, verify 
that your printer is listed. 

¢ Ifa parameter in the following tables is designated as not applicable for a particular 
printer, any value entered for the parameter will be ignored, but the place holder for the 
field is required. 
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Calibrate RFID Transponder Position 
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Description This command initiates an RFID transponder calibration for a specific RFID 
label and returns the results to the host computer. This calibration is used to determine the 
optimal programming position for RFID media that may not meet the transponder placement 
specifications for the printer. 


Note « Do not perform transponder calibration for RFID media that meets the transponder 
placement specifications for your printer. Doing so will slow the printer’s throughput 
unnecessarily. To order media that is designed for use with your RFID printer, contact your 
authorized Zebra reseller. 


During transponder calibration, the printer feeds the RFID label one-dot row at a time while 
taking readings (via the READ TAG command and the WRITE TAG commands) to profile the 
RFID transponder. Based on the results, the printer determines the optimal programming 
position for the label and returns a results table to the host. The calibrated value is used as the 
programming position for the “RS command, can be overwritten by the *RS command, and is 
saved to nonvolatile memory (the value is saved even if the power is turned off). 


This calibration takes into account the print mode, backfeed mode, and tear off position. The 
RUH option inthe RFID TAG CALIE control panel parameter performs the same 
calibration but does not create a results table. 


Important « Ifa label format specifies a value for parameter p (read/write position of the 
transponder) in the *RS command, that value will be used for the programming position for 
all RFID labels until a new position is specified or until the printer is turned Off (O) and then 
back On (I). 


Table 13 ¢ Printers That Support “HR 


Printer Firmware Version Supported? 
R110Xi/R170Xi R60.13.X Yes 
R110PAX4 R62.13.X Yes 
R63.13.X Yes 
R4Mplus SP920X No 
SP994X Yes 
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Format *HRa,b 


This table identifies the parameters for this format. 


Parameters 


a start string 


Details 

User text to appear before the results table. 
Accepted values: any string less than 65 characters 
Default value: start 


b = end string 


Comments 


User text to appear after the results table. 
Accepted values: any string less than 65 characters 
Default value: end 


¢ Based on the recommended transponder placement position for most RFID labels, the 
printer’s default RFID programming position is zero for the R110PA4X4. For other RFID 


printers, the default programming position is the label length minus 1 mm (0.04 in.). 


To return to the default programming position at any time, use the RESTORE option in the 
RFIO TAG CALIE control panel parameter. 


¢ At the end of calibration, a results table is returned to the host. Each line in the results 


table appears as: 


Row, Read Result, Write Result 


where 


Row = the dot row where calibration occurred 
Read Result = results of calibration (R = read, “” = unable to read) 


Write Result = results of calibration (W = write, 


co 99 
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Example « If the following command is sent to the printer: 


“XA°HR* XZ 
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The printer starts the transponder calibration and returns a results table such as the following: 


start 


position=195 


v 
’ 
’ 
v 
’ 
’ 


W 


WO 
OY 
~ 
x 
SPSS VQaaaeaaaaaas 


end 


<-- aK KKK 


In this example, the optimal programming position is 195. This is identified at the top of the 
table (pOSition=1 95) and with an the arrow (<---****) in the table. 


Printer 
R110X7/R170X7 
RI10PAX4 


R4Mplus 
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Table 14 ¢ Printers That Support “HV 


Firmware Version Supported? 
R60.13.X Yes 
R62.13.X Yes 
R63.13.X Yes 

SP920X Yes 
SP994X Yes 
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“RA 
Read AFI Byte 


Description This command is used to read the AFI byte. The data can be sent back to the 
host via the “HV command. 


Table 15 ¢ Printers That Support “RA 


Printer Firmware Version Supported? 
RI10X7/R170Xi R60.13.X No 
RI1L0PAX4 R62.13.X No 
R63.13.X No 
R4Mplus SP920X No 
SP994X No 
RH OXMMPlus SP936I No 
SP939A Yes 


Format *RA#,£,r,m 


This table identifies the parameters for this format. 


Parameters Details 
# = field number The value assigned to this parameter should be the same as the one 
specified with used in the *RT command. 
another Accepted values: 0 to 9999 
commend Default value: 0 
f = format Accepted values: 
0 = ASCII 
1 = Hexadecimal 


Default value: 0 


number of retries | Accepted values: 0 to 10 


re = 
Default value: 0 
m = motion Accepted values: 
QO = Feed label after writing. 


1 = No Feed after writing. Other ZPL may cause a feed. 
Default value: 0 
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— Example « This example reads the AFI byte in ASCII format and returns AFI Byte:x 
to the host. The printer will retry the command five times if necessary. A voided label is 
generated if the read is unsuccessful after these retries. The data read will go into the *FN1 
location of the recalled format. 


“XA 

“FO20,120*°A0N, 60*°FN1*FS 
“RA1,0,5,0*FS 

“HV1,,AFI Byte:*FS 

“XZ, 
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“RB 
Define EPC Data Structure 


Description This command defines the structure of EPC data, which can be read from or 
written to an RFID transponder. For more information about EPC specifications, refer to the 


EPC Global web site. 


RFID transponders can have different partitions defined. This command specifies the number 
of partitions and how many bits are in each partition. 


Important « All parameters in this command are persistent and will be used in subsequent 
formats if not provided. The values are initially set to the default values. 


Table 16 ¢ Printers That Support “RB 


Printer Firmware Version Supported? 
R110X7/R170Xi R60.13.X Yes 
RI1L0PAX4 R62.13.X Yes 
R63.13.X Yes 
R4Mplus SP920X No 
SP994X Yes 
Format *RBn,p0,pl,p2, ..., pl5 


This table identifies the parameters for this format. 


Parameters Details 


n = total bit sizeof | Accepted values: | to n, where n is the bit size of the tag. 


the field Default value: 96 
pl we. PIS= Specify each partition size. These must add up to the total bit size. 
partition sizes Accepted values: 1 to 64 bit total bit size 


Default value: 1 


45541L-003 Rev. A ZPL II] Programming Guide For x.10 through x.13 Firmware 6/9/06 


6/9/06 


RFID Commands | 293 
ARB 


Example 1 * The following command specifies that there are 96 bits used with three fields. 
Fields 1, 2, and 3 contain 10, 26, and 60 bits, respectively. 


“RB96,10,26, 60 


The ZPL code to write to a tag with this format would look like this: 
“REW, E* FD1000.67108000.1122921504606846976*FS 


When writing to the tag, the data will be stored in the tag in the following way: 
¢ Field 1 contains 1000. This value is stored in the first 10 bits 
¢ Field 2 contains 67108000. This value is stored in the next 26 bits. 


¢ Field 3 contains 1122921504606846976. This value is stored in the remaining 
60 bits. 


Example 2 « The following command specifies that there are 64 bits used with eight 8-bit 
fields. 


“RB64,8,8,8, 8, 8,8, 8, 8°FS 


The ZPL code to write to a tag with this format would look like this: 


“REW, EX FD1.123.160.200.249.6.1.0*FS 


When writing to the tag, each set of data is written in its respective 8-bit field. 
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—> 


Example 3 « This example uses the SGTIN-64 standard, which defines 64-bit structure in the 
following way: 


Header Filter Value Sey Item Reference | Serial Number 
Prefix Index 
SGTIN-64 2 bits 3 bits 14 bits 20 bits 25 bits 
10 8 16,383 9 to 1,048,575 33,554,431 
(binary value) (decimal (decimal (decimal (decimal 
capacity) capacity) capacity*) capacity) 


* Capacity of Item Reference field varies with the length of the company prefix. 


The ZPL code to write to a tag with this format would look like this: 


“XA 


“XZ 


These commands would put 


¢ 0 in the header 
¢ 3 as the filter value 


ARB64,2,3,14,20,25 
ARFW, E* FDO, 3, 12345, 544332, 22335221°FS 


¢ 12345 as the company prefix 


¢ 544332 as the item reference 
¢ 22335221 as the serial number 


To read this EPC data and print the results on the label, you would use the following code: 


“XA 


ARB64,2,3,14,20,25 


“FO50,50°A0N, 40° FNO*FS 
“FNO*RER, EX FS 


“XZ 


The resulting label would look like this: 


Va 


0.3.12345.544332.22335221 
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RFID Command 
ARE 


Enable/Disable E.A.S. Bit 


Description This command is used to enable or disable the E.A.S. bit that is available in 
some ISO15693 tags (such as Philips). This command works only on those ISO15693 
transponders and will be ignored if the tag does not support E.A.S. 


Table 17 ¢ Printers That Support “RE 


Printer Firmware Version Supported? 
R110X7/R170Xi R60.13.X No 
R110PAX4 R62.13.X No 
R63.13.X No 
R4Mplus SP920X No 
SP994X No 
RI OXMMPlus SP936I No 
SP939A Yes 


Format *REt,r 


The following table identifies the parameters for this format. 


Parameters 


= Enable/disable 
the E.A.S. bit in 
the ISO15693 
transponder 


t 


rx = number of retries 


five times if necessary. 


“XA 
“REY, 5 
“XZ 
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Details 

Accepted values: 
N = Disable E.A.S. 
Y = Enable E.A:S. 


Default value: N 


Accepted values: 0 to 10 
Default value: 0 


Example « This example enables the E.A.S. bit in the transponder. It will retry the command 
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ARF 
Read or Write RFID Format 
Description This command allows you to read or write to an RFID tag. 


& Note * When using this command to read a tag, you may use a field variable to print the tag 
5 data on the label or to return the data to the host. 


Table 18 ¢ Printers That Support “RF 


Printer Firmware Version Supported? 
R110X7/R170Xi R60.13.X Yes 
R1I1L0PAX4 R62.13.X Yes 
R63.13.X Yes 
R4Mplus SP920X No 
SP994X Yes 


Format *RFo,t,b,n 


This table identifies the parameters for this format. 


Parameters Details 
© = operation The action to be performed. 
Accepted values: 


W = write to the tag 
L = write with LOCK (if supported by tag type; Gen 2 does 
not use this locking function) 
R = read the tag 
Default value: W 


t = type Accepted values: 
A = ASCII 
H = Hexadecimal 
E = EPC (ensure proper setup with the ~RB command) 
Default value: H 
b = starting block Accepted values: 0 to n, where n is the maximum number of 
number blocks for the tag. 
Default value: 0 
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Parameters Details 


n = number of bytes 3 Note ¢ This parameter is used only by the R4Mplus with 
to read or write firmware version SP994X (R4Mplus European version). 


This parameter applies only when the starting block number is 1. 


Accepted values: | to n, where n is the maximum number of bytes 
for the tag. For UCODE EPC 1.19, n is 32. 


Default value: | 


—> Examples « 


Write ASCII 
This example writes 96-bit data. 


“XA 

“RS4 

“RFw,a*FDOO my data*FS 
“XZ, 


Write Hex 
This example writes 64-bit data. 


“XA 

“RS3 

“REW, H°FD1122334455667788°FS 
“XZ 


Write EPC 
This example writes 96-bit data, as specified by the *RB command. 


“XA 

“RB96,8,3,3,20,24, 38 

“RFw, e*FD16, 3,5, 78742,146165,1234567891%FS 
“XZ 
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ARI 
Get RFID Tag ID 


Description This command is used get the unique serial number of the tag. The serial 
number is returned in hexadecimal format. 


Table 19 ¢ Printers That Support “RI 


Printer Firmware Version Supported? 
R110X7/R170Xi R60.13.X No 
RI1L0PAX4 R62.13.X No 
R63.13.X No 
R4Mplus SP920X No 
SP994X No 
RH OXMMPlus SP936I No 
SP939A Yes 


Format *RI#,s,r,m 


This table identifies the parameters for this format. 


Parameters Details 
# = number to be Accepted values: 0 to 9999 
assigned to the — | Default value: 0 
field 
s = specify data Accepted values: 
order 0 = MSB first for Tag*It and PicoTag. LSB first for I*code 
and ISO15693 
1 = Reverse the data order 


Default value: 0 


x = number of retries | Accepted values: 0 to 10 
Default value: 0 


m = motion Accepted values: 

0 = Feed label after writing. 

1 = No Feed after writing. Other ZPL may cause a feed. 
Default value: 0 
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— Example « This example reads a tag ID, prints it on a label, and sends string 
Tag ID:xxxxxxxx to the host. The data read will go into the *FNO location of the 
format. The printer will retry the command five times, if necessary. 


“XA 

“FO20,120*°A0N, 60*FNO*FS 
“RIO, ,5°FS 

“HV0O,,Tag ID:*FS 

“XZ 
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“RM 
Enable RFID Motion 
Description This command enables or disables RFID motion. By default, labels 
automatically print at the end of the format. This command allows you to inhibit the label from 


actually moving when it reaches the program position, which is useful for debugging, setup, 
and custom applications. This parameter is not persistent (carried over from label to label). 


Table 20 « Printers That Support “RM 


Printer Firmware Version Supported? 
R110X7/R170Xi R60.13.X Yes 
RI1L0PAX4 R62.13.X Yes 
R63.13.X Yes 
R4Mplus SP920X No 
SP994X Yes 


Format *RMe 


This table identifies the parameters for this format. 


Parameters Details 
e = enable Accepted values: 

Y = Yes, move the label 

N = No, do not move the label 
Default value: Y 
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Detect Multiple RFID Tags in Encoding Field 


6/9/06 


Description This command enables or disables detection of multiple RFID tags in the 
encoding field. By default, the printer checks for more than one tag in the field before 
attempting to read or write. If more than one tag is found, the label over the antenna support is 
voided, and the RFID ERR STATUS parameter on the control panel displays 

MULTIPLE TAGS. To speed up printing and encoding by up to 200 ms, the check may be 
disabled. This parameter is persistent (carried over from label to label). 


Table 21 ¢ Printers That Support “RN 


Printer Firmware Version Supported? 
R110X7/R170Xi R60.13.X Yes 
(R60.13.03 or higher) 
R110PAX4 R62.13.X Yes 
R63.13.X Yes 
R4Mplus SP920X No 
SP994X No 


Format *“RNe 


The following table identifies the parameters for this format. 


Parameters Details 

e = enable Accepted Values: 

Y = Yes, check for multiple tags 

N = No, do not check for multiple tags 


Default Value: Y 
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~RO 


Reset Advanced Counters 


Description The ~RO command resets the advanced counters used by the printer to monitor 
label generation in inches and centimeters, the number of labels printed, and the number of 

valid and voided RFID labels. Any single error during programming of an RFID tag will result 
in that label being considered “void” by the counter. 


Four resettable counters are available. The values for the counters are displayed on the printer 


configuration label. 


Note ¢ For the R4Mplus, the counter values are not saved, so power cycling the printer resets 


all counters to zero. 


Table 22 ¢ Printers That Support ~RO 


Printer Firmware Version Supported? 
R110X7/R170Xi R60.13.X Yes 
R1I10PAX4 R62.13.X Yes 
R63.13.X Yes 
R4Mplus SP920X No 
SP994X Yes 


Format ~ROc 


This table identifies the parameters for this format: 


Parameters 


Cc =counter to reset 
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LL = 
2. = 
3 = 
4 = 


ignored. 


Accepted Values: 


counter 1 
counter 2 


valid RFID label counter 
voided RFID label counter 
Default Value: None. If a value is not specified, the command is 
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~RO 
—> Example 1 « This example shows how the counter portion of the printer configuration labels 
looks when counter | is reset by sending ~RO1. 
Before 
296862 . NONRESET CNTR 
——— > 296862 RESET CNTR1 
296862 > RESET CNTR2 
753289 NONRESET CNTR 
———— > 753289 RESET CNTR1 
753289 CM... ss... RESET CNTR2 
92928 LABLS......-: NONRESET CNTR 
———— 92928 LABLS. 22222 :. RESET CNTR1 
92928 LABLS........ RESET CNTR2 
After 
296876 IN.......... NONRESET_CNTR 
Nosovaead acess: RESET CNTR1 
296876 IN.......... RESET CNTR2 
753323 CM... lls. NONRESET CNTR 
——_P om... ee. RESET CNTR} 
753323 Ch. . ) RESET CNTR2 
92930 LABLS >. NONRESET CNTR 
———— 0 LABLS..... .. RESET CNTR1 
92930 LABLS. . . RESET CNTR2 
—> Example 2 « This example shows how the counter portion of the printer configuration labels 
looks when the RFID counters are reset by sending ~RO3 and ~RO4. 
Before 
02/10/05.......+-4. RTC DATE 
O7821 a scincieiscinades RTC_TIME 
——_——_ PH 507... RFID VALID CTR 
—$ 4! RFID VOID CTR 
HIGH fer-csce awa eeares RFID READ PWR 
IGH icc vemewe cues RFID WRITE PWR 
RFID OK.......--00- RFID ERR STATUS 
Class 0.........00. RFID TAG TYPE 
TM: 20050201......: RFID VERSION 
1950 IN......ceeeee NONRESET CNTR 
1950 IN....s.seee ee RESET CNTR1 
1950 IN.......eeeee RESET CNTR2 
After 
02710/05.........4- RTC DATE 
07221... 0.0. c cece eee RTC TIME 
PP Gino incccnncncncnos RFID VALID CTR 
—— 00! RFID VOID CTR 
HIGH 050 cie.cierneccecies a RFID READ PWR 
HIGH 5 cieccisicisaveince cnesare RFID WRITE PWR 
RFID OK.......0000- RFID ERR STATUS 
Class O..........-. RFID TAG TYPE 
TM: 20050201....... RFID VERSION 
1951 IN.....cceeeee NONRESET CNTR 
1951 IN.....ceeee ee RESET CNTR1 
1951 IN.......s0eee RESET CNTR2 
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“RR 


Specify RFID Retries for a Block 


Description This command changes the number of times that the printer attempts to read or 
write to a particular block of a single RFID tag. By default, the printer will attempt six retries. 
This command is persistent and will be used in subsequent formats if not provided. 


Important * This command’s function is different than the “number of labels” parameter in 


the “RS command. 


Table 23 ¢ Printers That Support “RR 


Printer Firmware Version Supported? 
R110X7/R170Xi R60.13.X Yes 
R1I10PAX4 R62.13.X Yes 
R63.13.X Yes 
R4Mplus SP920X No 
SP994X Yes 


Format *RRn 


This table identifies the parameters for this format. 
Parameters Details 


n = number of retries | Accepted values: 0 to 10 


Default value: 0 


Examples ¢ 

Set read block retries to 5 
“XA 
“FNI*RRS*RER, H*FS 
“HV1L*FS 
#XZ 


Set write block retries to 2 


“XA 
“RR2“REW, H°FD1234°FS 
“XZ 
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Description This command sets up parameters including tag type, read/write position of the 
transponder, and error handling. 


Important ¢ Use care when using this command in combination with *RT or “RF for 
reading tag data. Problems can occur if the data read from the tag is going to be printed on the 

label. Any data read from the transponder must be positioned to be printed above the 

read/write position. Failure to do this will prevent read data from being printed on the label. 


Table 24 « Printers That Support “RS 


Printer Firmware Version Supported? 
R110X7/R170Xi R60.13.X Yes 
RI1L0PAX4 R62.13.X Yes 
R63.13.X Yes 
R4Mplus SP920X Yes 
SP994X Yes 


Format *RSt,p,v,n,e,a,C,s 


This table identifies the parameters for this format. 


Parameters 


t = tag type 
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For the R110Xi/R170Xi: 
Accepted Values: 


0 


DN oOP WN FP 


8 


= None 


EPC Class 0 
EPC Class 0 Plus 


= EPC Class 1 64-bit 
= EPC Class 1 96-bit 
= ISO 18000-06B 

Impinj Class 0 Plus 


Important * Some countries restrict the frequencies that 
can be used for RFID, so your printer may not support all 
of the tag types listed. If you specify an unsupported tag 
type, the printer uses the default value. 


EPC Class 1, Generation 2 (Gen 2) 
Default value: 4 


(continued on next page) 
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Parameters Details 
t = tag type (continued from previous page) 
Important * Some countries restrict the frequencies that 
i! | can be used for RFID, so your printer may not support all 
of the tag types listed. If you specify an unsupported tag 
type, the printer uses the default value. 


For the R4Mplus with firmware version SP920H or higher 
(U.S. version): 
Accepted Values: 
3 = EPC Class | 64-bit 
4 = EPC Class | 96-bit 
Default value: 4 
For the R4Mplus with firmware version SP994X (European 
version): 
Accepted Values: 
3 = EPC Class 1 64-bit 
4 = EPC Class | 96-bit 
5 = ISO 18000-06B 96-bit 
7 = ISO 18000-06A (read only) 
8 = EPC Class 1, Generation 2 (Gen 2) 
Default value: 5 


For all other supported printers: 
Accepted Values: 
O = None 
= EPC Class 0 
= EPC Class 0 Plus 
= EPC Class 1| 64-bit 
= EPC Class | 96-bit 
= ISO 18000-06B 
= Impinj Class 0 Plus 
= ISO 18000-06A 
8 = EPC Class 1, Generation 2 (Gen 2) 
Default value: 4 


YOO 8B WN EH 
| 
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Parameters Details 
p = read/write Sets the read/write position of the transponder in vertical (Y axis) 
position of the dot rows from the top of the label. Set to 0 (no movement) if the 
transponder transponder is already in the effective area without moving the 
media. 


parameter, this value will be used for the programming 
position for all labels until a new position is specified or 
until the printer is powered Off (O) and then back On (I). 
Accepted values: 0 to label length 
Default value: 
For the R110PAX4: 0 
For all other supported printers: label length minus | mm 


Important ¢ Ifa label format specifies a value for this 


(1/16 in.) 
v_ = length of void Sets the length of the void printout in vertical (Y axis) dot rows. 
printout Accepted values: 0 to label length 


Default value: label length 


n = number of labels | The number of labels that will be attempted in case of read/encode 
failure. 


Accepted values: 1 to 10 
Default value: 3 


O 
| 


= error handling If an error persists after the specified number of labels are tried, 
perform this error handling action. 
Accepted values: 
N = No action (printer drops the label format causing the 
error and moves to the next queued label) 
P = Place printer in Pause mode (label format stays in the 
queue until the user cancels) 
E = Place printer in Error mode (label format stays in the 
queue until the user cancels) 
Default value: N 
Note ¢ You can set the printer to send an error message to 
the host for each failure. To enable or disable this 
unsolicited error message, refer to the *SX and *SQ ZPL 
commands. Use V for the condition type for an RFID error. 
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Parameters Details 
a signals on. =) Note ¢ For the R4Mplus, this parameter applies only to 
applicator printers with firmware version SP994X (R4Mplus 


European version). 


When the value for parameter p (read/write position of the 
transponder) is nonzero, this parameter changes the number of 
start and stop print signals required for printing. 
In Single mode, one start print command is required. In Double 
mode, two are required, so the printer will resume printing only 
after the second start print command is received. 
Accepted values: 
S = single signal 
D = double signal (For the R110P4X4, Double mode will 
work only if the read/write position is changed from the 
default of zero.) 
Default value: S 


c = certify tag witha | Not applicable. 
pre-read 


S = void print speed | Note + For the R4Mplus, this parameter applies only to 
printers with firmware version SP994X (R4Mplus 
European version). 


If a label is voided, the speed at which “VOID” will be printed 
across the label. 


Accepted values: any valid print speed 


Default value: the printer’s maximum print speed 
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—> Example 1 « This example sets the printer to move the media to 800 dots from the top of the 
media [or label length minus 800 from the bottom (leading edge) of the media] and voids the 
rest of the media in case of an error. The printer will try to print two labels and then will 
pause if printing and encoding fail. 


“XA 

“RS, 800,,2,P*FS 

“XZ 
Figure 3 shows the resulting voided label. Note where the void starts. The media has been 
moved 800 dot rows from the top of the label (label length minus 800 dot rows from the 
bottom (leading edge) of a label) to bring the transponder into the effective area to read/write 
a tag. If the printer fails the operation, the rest of the media is voided. 


Figure 3 * Sample Void Label, Remainder of Label Voided 


Top of label 


lL VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
800 dot VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
oT rows VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 


VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
Vv VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 


VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
Start of RFID el VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 


operation 


Label length minus 
800 dot rows 


Bottom of label 
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—> Example 2 « This example sets the printer to move the media to 800 dots from the top of the 
media [or label length - 500 from the bottom (leading edge) of the media] and prints “VOID” 
500 dots in vertical length (Y axis) in case of an error. 


“XA 

“RS, 800,500,2, P*EFS 

“XZ, 
Figure 4 shows the resulting voided label. Note where the void starts. The media has been 
moved 800 dot rows from the top of the label [label length minus 800 dot rows from the 
bottom (leading edge) of a label] to bring the transponder into the effective area to read/write 
a tag. If the printer fails the operation, an area that is 500 dot rows of the media is voided 
instead of the entire rest of the media. 


Figure 4 * Sample Void Label, 500 Dot Row Area Voided 


Top of label 
A 


—_ VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
800 dot rows VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
500 dot rows VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 


VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
v v VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 


VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
Start of RFID VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 
ail Ma pe VOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOIDVOID 


operation 


Label length minus 
800 dot rows 


Bottom of label 
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ART 
Read RFID Tag 


Description This command tells the printer to read the current RFID tag data. The data can 
be sent back to the host via the “HV command. 


Table 25 « Printers That Support “RT 


Printer Firmware Version Supported? 
R110X7/R170Xi R60.13.X Yes* 
R110PAX4 R62.13.X Yes* 
R63.13.X Yes* 
R4Mplus SP920X Yes 
SP994X Yes* 


* It is recommended that you use the “RF, “RM, and *RR commands rather than the *RT 
command. The *RT command is provided only for backward-compatibility with label 
formats that were developed for older Zebra RFID printers. 


Format *RT#,b,n,f£,r,m,s 


This table identifies the parameters for this format. 


Parameters Details 
# = number to be Accepted values: 0 to 9999 
assigned to the — | Default value: 0 
field 
b = starting block Accepted values: 0 to n, where n is the maximum number of 
number blocks for the tag. 
Default value: 0 
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Parameters Details 
n = number of =) Note « This parameter does NOT apply to R4Mplus 
blocks/bytes printers with firmware version SP920.Y (R4Mplus U.S. 


to read version). 


For R4Mplus printers with firmware version SP994X 
(European version): 

This parameter applies only when the starting block number 
(parameter b) is 1. 


Accepted values: | to n, where n is the maximum number of bytes 
for the tag. For UCODE EPC 1.19, is 32. 


Default value: | 


For all other supported printers: 

Accepted values: | ton, where n is the maximum number of 
blocks for the tag type minus the starting block number. For 
example, if the tag has 8 blocks (starting with block 0) and you 
start with block 6, n can be 2. This would return block 6 and block 
7 information. 


Default value: | 


f£ = format Accepted values: 
0 = ASCII 
1 = Hexadecimal 


Default value: 0 


x = number of retries | Changes the number of times that the printer attempts to read a 
particular block of a single RFID tag. (Same retry rules as the 
“RR command.) 

Accepted values: 0 to 10 


Default value: 0 


m = motion Enables or disables RFID motion for the current field. 
Accepted values: 
0 = Feed label after writing. 
1 = No feed after writing. Other ZPL may cause a feed. 
Default value: 0 
sg = 


special mode Ey) Note This parameter applies only to R4Mplus printers 
with firmware version SP920.X (R4Mplus U.S. version). 


For EPC Class 1 (Alien reader) only. Not applicable for EPC class 
0. 


Default value: 0 
Accepted values: 


0 = Do not read if mismatched checksum 
al 


Read even if mismatched checksum 
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—_> Example « This sample reads a tag, prints the data on a label, and sends the string 
Tag Data: xxxxxxxx back to the host. The data read will go into the *FN1 location of 
the format. The printer will retry the command five times, if necessary. 


“XA 

“FO20,120°A0N, 60*FN1*FS 
“REL pp po ES 

“HV1,,Tag Data:*FS 

“XZ 
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A 
RW 
Set RFID Read and Write Power Levels 
Description This command sets the read and write power levels. This function is useful 
when using different tag types or transponders that require different power levels to obtain the 


best read and write abilities. 


Table 26 « Printers That Support “RW 


Printer Firmware Version Supported? 
R110X7/R170Xi R60.13.X Yes 
R110PAX4 R62.13.X Yes 
R63.13.X Yes 
R4Mplus SP920X No 
SP994X Yes 


Format *“RWr,w 


This table identifies the parameters for this format: 


Parameters Details 
rx = read power Sets the power level to match the desired output as calibrated in 
the factory. 
Accepted Values: 
H = high 
M = medium 
L = low 
Default Value: H 
w = write power Sets the power level to match the desired output as calibrated in 
the factory. 


Accepted Values: 
H = high 
M = medium 
L = low 
Default Value: H 
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Set RFID Tag Password 
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Description This command lets you define the password for the tag during writing. 


Important ¢ Only certain tags support this feature, so check to ensure that this command can 
be used with your particular tag type. 


Table 27 ¢ Printers That Support “RW 


Printer Firmware Version Supported? 
R110X7/R170Xi R60.13.X Yes 
R11L0PAX4 R62.13.X Yes 
R63.13.X Yes 
R4Mplus SP920X No 
SP994X No 


Format *RZp 


The following table identifies the parameters for this format. 


Details 
Accepted values: 00 to FF (hexadecimal) 
Default value: 00 


Parameters 


p = password 
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AWE 


Write AFI Byte 


Description This command is used to write the AFI byte to a transponder. Error handling is 
set by the *RS command. 


Table 28 « Printers That Support “WF 
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Printer Firmware Version Supported? 
R110X7/R170Xi R60.13.X No 
RI1L0PAX4 R62.13.X No 
R63.13.X No 
R4Mplus SP920X No 
SP994X No 
RII1OXMTPlus SP936I No 
SP939A Yes 


Format “WFr,m,w,f 


The following table identifies the parameters for this format. 


Parameters Details 


x = number of retries | Accepted values: 0 to 10 
Default value: 0 


m = motion Accepted values: 
0 = Feed label after writing. 


Default value: 0 


1 =No Feed after writing. Other ZPL may cause a feed. 


WwW = write protect Accepted values: 
0 = Not write protected 
1 = Write protect 
Default value: 0 


f = data format Accepted values: 

0 = ASCII 

1 = Hexadecimal 
Default value: 0 


Example 1 * This example encodes data “R” (hex 52) as the AFI byte. The printer will try 


the command up to five times, if necessary. 
“XA 


“WE5* FDR 
“XZ 
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AWF 
—> Example 2 « This example encodes data hex 66 as the AFI byte. The printer will try the 
command up to five times, if necessary. 
“XA 
SWE5,,,1°FD66 
“XZ 
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AWT 
Write Tag 


Description This command allows you to program the current RFID tag. 


Important * Check the amount of data memory available for the tag that you will be using. If 
more data is sent than the memory can hold, the printer truncates the data. 


Table 29 « Printers That Support “WT 


Printer Firmware Version Supported? 
R110X7/R170Xi R60.13.X Yes* 
R110PAX4 R62.13.X Yes* 
R63.13.X Yes* 
R4Mplus SP920X Yes 
SP994X Yes* ** 


* Tt is recommended that you use the “RF, “RM, “RR, and “WV commands rather than the 
“WT command. The “WT command is provided only for backward-compatibility with label 
formats that were developed for older Zebra RFID printers. 


** With this command, you can write 12 bytes (96 bits) to block 0, but you can write only 
the first byte of block 1. 


Format “WTb,r,m,w,f,v 


This table identifies the parameters for this format. 


Parameters Details 


b = block number | Note + For the R4Mplus, this parameter applies only to 
printers with firmware version SP994X (R4Mplus 
European version). 


This parameter is tag-dependent. For most tags, use block 0. For 
EPC Class 0 Plus, block 0 is EPC data, and block 1 is user data. 
Accepted values: 0 ton, where n is the maximum number of 
blocks for the tag. 

Default value: 0 

x = number of retries | Changes the number of times that the printer attempts to write to a 
particular block of a single RFID tag. (Same function as the *RR 
command.) 


Accepted values: 0 to 10 
Default value: 0 
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Parameters 


m motion 


w = write protect 
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Details 
Enables or disables RFID motion. (Same function as the *RM 
command.) 
Accepted values: 
O = Feed label after writing 
1 = No feed after writing (other ZPL may cause a feed) 
Default value: 0 
Accepted values: 
0 = Not write protected 
1 = Write protected 
Default value: 0 


f£ = data format Accepted values: 
0 = ASCII 
1 = Hexadecimal 
Default value: 0 
v = verify valid data | For reliability, some manufacturers encode tags with known data 


(such as A5A5). This parameter flags whether the preprogrammed 
data is verified. (Same function as the “WV command) 


Accepted values: 

N = Do not verify 

Y = Verify valid data before writing 
Default value: N 


v = reverse the data 
order 


Not applicable. 


Example « This sample encodes data “RFIDRFID” and will try writing up to five times, if 


necessary. 


“XA 


“WT, 5°FDRFIDRFID*FS 


“XZ 
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AWV 
Verify RFID Write Operation 


Description If write verify is enabled, this command verifies the RFID write operation to 


ensure that the tag about to be programmed contains the hex data “A5A5” in the first two 


bytes. This parameter is not persistent (carried over from label to label). 


Table 30 « Printers That Support “WV 


Printer Firmware Version Supported? 
R110X7/R170Xi R60.13.X Yes 
R110PAX4 R62.13.X Yes 
R63.13.X Yes 
R4Mplus SP920X No 
SP994X Yes 


Format “wVe 


This table identifies the parameters for this format. 


Parameters Details 


Accepted values: Y or N 
Default value: N 


e = enable 
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4. 


Wireless Print Server 
Commands 


This section contains new or modified ZPL commands for the Wireless Print Server. 
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“NB 
Search for Wired Print Server during Network Boot 


Description Use this command to tell the printer whether to search for a wired print server 
at bootup. Table 31 shows the results of this check. 


Table 31 * Results of Check for Wired Print Server 


Wired Print 
Server 
Connected? 


Check for Wired 
Print Server? Results 
Yes Skip The printer does not check for or acknowledge 
the wired print server. The Wireless Print Server 
is used as the primary print server. 


Yes Check The printer checks for a wired print server. If the 
printer detects the wired print server, it uses it as 
the primary print server. If the printer does not 
detect the wired print server, the Wireless Print 
Server is used as the primary print server. 


No Skip The printer does not check for a wired print 
server. The Wireless Print Server is used as the 
primary print server. 


No Check During bootup, the printer tries for 70 seconds to 
detect a wired print server. Because a wired print 
server is not connected, the printer uses the 

Wireless Print Server as the primary print server. 


Format *“NBa 


The following table identifies the parameters for this format. 


Details 


Accepted Values: C (CHECK), S (SKIP CHECK) 
Default Value: S 


Parameters 


a = check for wired 
print server at 
boot time 
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Set SNMP 
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Description Use this command to set the Simple Network Management Protocol (SNMP) 


parameters. 


Format *“NNa,b,c,d,e,f 


The following table identifies the parameters for this format. 


Parameters 


a = system name 


Details 


Same as printer name. 


Accepted Values: Up to 17 alphanumeric characters 


b = system contact 


Any contact information as desired (such as a name or phrase) 
Accepted Values: Up to 50 alphanumeric characters 


c = system location 


The printer’s model information. 


Accepted Values: Up to 50 alphanumeric characters 


d = get community 
name 


Accepted Values: Up to 19 alphanumeric characters 
Default Value: public 


e = set community 
name 


Accepted Values: Up to 19 alphanumeric characters 
Default Value: public 


f = trap community 
name 


Accepted Values: Up to 20 alphanumeric characters 
Default Value: public 
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ANP 
Set Primary/Secondary Device 


Description Use this command to specify whether to use the printer’s or the print server’s 
LAN/WLAN settings at boot time. The default is to use the printer’s settings. 


When the printer is set as the primary device, you can set it up using ZPL commands or the 
SetWLAN utility, and any wired print server inserted into the printer will get these settings. 


Format *NPa 


The following table identifies the parameters for this format. 


Details 


Accepted Values: P (PRINTER), M (MPS/PRINTSERVER) 


Parameters 


a = device to use as 
primary 
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Change Wired Networking Settings 


Description Use this command to change the wired print server network settings. 


Format *NSa,b,c,d,e,f,9g,h,i 


The following table identifies the parameters for this format. 


Parameters 


a = /Presolution 


Details 


Accepted Values: 

A (ALL) 

B (BOOTP) 

C (DHCP AND BOOTP) 
D (DHCP) 

G (GLEANING ONLY) 
R (RARP) 

P (PERMANENT) 


Note « Use of GLEANING ONLY is not recommended when the 
Wireless Print Server is installed. 


b = IP address 


Accepted Values: Any properly formatted IP address in the 
XXX.XXX.XXX.XXxX format. 


c = subnet mask 


Accepted Values: Any properly formatted subnet mask in the 
XXX.XXX.XXX.XXX format. 


d = default gateway 


e = WINS server 
address 


Accepted Values: Any properly formatted gateway in the 
XXX.XXX.XXX.XXX format. 


Accepted Values: Any properly formatted WINS server in the 
XXX.XXX.XXX.XXX format. 


f = connection 
timeout checking 


Accepted Values: Y (YES), N (NO) 


g = timeout value 


Time, in seconds, before the connection times out. 
Accepted Values: 0 through 9999 


h = ARP broadcast 
interval 


Time, in minutes, that the broadcast is sent to update the device’s 
ARP cache. 


i = base raw port 
number 


—= > Example « 
“XA 


The port number that the printer should use for its RAW data. 
Accepted Values: 0 through 99999 
Default Value: 9100 


“NSa, 192.168.0.1,255.255.255.0;192.168.0.2 
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ANT 
Set SMTP 


Description Use this command to set the Simple Mail Transfer Protocol (SMTP) 
parameters. This allows you to set the e-mail settings for alerts. 


Format “NTa,b 


The following table identifies the parameters for this format. 


Parameters Details 

a = SMTP server Accepted Values: Any properly formatted server address in the 
address XXX.XXX.XXX.XXX format 

b = print server Accepted Values: Any properly formatted print server domain in 
domain the xxx.xxx.xxx.xxx format 
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ANW 
Set Web Authentication Timeout Value 


Description Use this command to set the timeout value for the printer home page. The 
printer will prompt for the printer password only the first time that certain screens are accessed 
until 1) the web authentication timeout value is reached (default value is 5 minutes) or 

2) the printer is reset. At that time, the printer will prompt for the password again. 


Format *“NWa 


The following table identifies the parameters for this format. 


Parameters Details 
a = timeout value The timeout value in minutes for an IP address to be authenticated 
to the printer web pages. 


Accepted Values: 0 (no secure pages can be accessed without 
entering the printer password) to 255 minutes 


Default Value: 5 
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AWA 
Set Antenna Parameters 


Description Use this command to set the values for the receive and transmit antenna. 


Format “WAa,b 


The following table identifies the parameters for this format. 


Parameters Details 


a =receiveantenna | Accepted Values: D (Diversity), L (Left), R (Right) 
Default Value: D 


b = transmit antenna | Accepted Values: D (Diversity), L (Left), R (Right) 
Default Value: D 
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Description Use this command to command enable Wired Equivalent Privacy (WEP) mode 
and set WEP values. WEP is a security protocol for wireless local area networks (WLANs). 


Use care to include the exact number of commas required for this command when setting 
encryption keys (parameters e through h). A missing or extra comma will cause the keys to be 
stored in the wrong slots and can disable the wireless system. 


Format *WEa,b,c,d,e,f,g,h 


The following table identifies the parameters for this format. 


Parameters Details 


a = encryption mode | Accepted Values: OFF, 40 (40-bit encryption), 128 (128-bit 
encryption) 
Default Value: OFF 


b = encryption index | Tells the printer which encryption key to use. 
Accepted Values: | (Key 1), 2 (Key 2), 3 (Key 3), 4 (Key 4) 
Default Value: | 


c = authentication Accepted Values: O (Open System), S (Shared Key) 
type Default Value: O 


=) Note « If you enable Shared Key authentication with 
Encryption Mode set to OFF, this value resets to Open. 


d = encryption key Accepted Values: H (Hex key storage), S (string key storage) 
storage Default Value: H 

e, f, g h= Accepted Values: The actual value for the encryption key 
encryption keys | The encryption mode affects what can be entered for the 
1 through 4 encryption keys: 


* For 40-bit, encryption keys can be set to any 5 hex pairs or any 
10 alphanumeric characters. 

¢ For 128-bit, encryption keys can be set to any 13 hex pairs or 
any 26 alphanumeric characters. 


my) Note * When using hex storage, do not add a leading Ox on 
the WEP key. 


Example 1 ¢This example sets encryption to 40-bit, activates encryption key 1, and sets 
encryption key | to the string 12345. 


AWE40,,,,12345 


In this example, the Encryption Index, Authentication Type, and Encryption Key Storage 
parameters are left blank with commas as placeholders for the fields. The printer uses the 
default values for these parameters. 
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Example 2 eThis example sets encryption to 128-bit, activates encryption key 2, and sets 
encryption keys 1 and 2 to hex values. 


“WE128,2,,H,12345678901234567890123456, 98765432109876543 
210987654 


The value for encryption key | is stored and can be activated in the future by the following 
command: 


“WE128,1 


Example 3 eThis example sets encryption to 128-bit, activates encryption key 4, and sets 
encryption key 4 to a hex value. 


“WE128,4,,H,,,,98765432109876543210987654 


Values are not required for encryption keys 1 through 3 when setting encryption key 4. In this 
example, commas are used as placeholders for the fields for encryption keys | through 3. 
Any previously stored values for these encryption keys do not change. 


Important ¢ Make sure that you include the exact number of commas required to get 
to the slot for encryption key 4 (parameter h). 
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AWI 
Change Wireless Network Settings 
Description Use this command to change the wireless network settings. 


Format “Wla,b,c,d,e,f,9g,h,i 


The following table identifies the parameters for this format. 


Parameters Details 


a = IP resolution Accepted Values: 


A (ALL) 

B (BOOTP) 

C (DHCP AND BOOTP) 
D (DHCP) 

G (GLEANING ONLY) 
R (RARP) 

P (PERMANENT) 


Note « Use of GLEANING ONLY is not recommended when the 
Wireless Print Server is installed. 


IP address 


Accepted Values: Any properly formatted IP address in the 
XXX.XXX.XXX.XXxX format. 


subnet mask 


Accepted Values: Any properly formatted subnet mask in the 
XXX.XXX.XXX.XXX format. 


default gateway 


WINS server 
address 


Accepted Values: Any properly formatted gateway in the 
XXX.XXX.XXX.XXX format. 


Accepted Values: Any properly formatted WINS server in the 
XXX.XXX.XXX.XXX format. 


connection 
timeout checking 


Accepted Values: Y (YES), N (NO) 


timeout value 


Time, in seconds, before the connection times out. 
Accepted Values: 0 through 9999 


ARP broadcast 
interval 


Time, in minutes, that the broadcast is sent to update devices ARP 
cache. 


base raw port 
number 
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A 
WL 
Set LEAP Parameters 
Description Use this command to enable Cisco® Lightweight Extensible Authentication 
Protocol (LEAP) mode and set parameters. LEAP is user authentication method that is 


available with some wireless cards. 


Format *WLa,b,c 


The following table identifies the parameters for this format. 


Parameters Details 

a = mode Accepted Values: OFF, ON 

b = user name Default Value: Any 4 to 40 alphanumeric characters user 

Cc = password Default Value: Any 4 to 40 alphanumeric characters password 
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Format ~WwL 
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Description Use this command to generate a network configuration label (Figure 5). 


Figure 5 « Network Configuration Label 


Network Configuration 


Zebra Technologies 
PRINTER MODEL XXXdpi 
USER-DEFINED TEXT 


WIRED PS CHECK? 
LOAD LAN FROM? 


IP PROTOCOL 

000 .000.000. .... IP ADDRESS 

000 .000.000. .... SUBNET MASK 

000 .000.000. .... DEFAULT GATEWAY 

000 .000.000. -...- WINS SERVER IP 
TIMEQUT CHECKING 
TIMEQUT VALUE 
ARP_ INTERVAL 
BASE RAW PORT 


IP PROTOCOL 
010.003.015. .... IP ADDRESS 
255.255.255. .... SUBNET MASK 
010.003.015. .... DEFAULT GATEWAY 
010.003.001. .... WINS SERVER IP 

TIMEQUT CHECKING 

TIMEQUT VALUE 


CARD INSERTED 
CARD MFG ID 

CARD PRODUCT ID 
MAC ADDRESS 
DRIVER INSTALLED 
OPERATING MODE 
ESSID 


Mb/s 
CURRENT TX RATE 
DIVERSITY RECEIVE ANTENNA 
CE eee xMIT ANTENNA 


ENCRYPTION MODE 
ENCRYPT. INDEX 
POOR SIGNAL 
PREAMBLE 
ASSOCIATED 


FIRMWARE IN THIS PRINTER IS COPYRIGHTED 
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“WP 


Set Wireless Password 


Description Use this command to set the four-digit wireless password (not the same as the 
general printer password). If the wireless password is 0000, the Wireless Print Server runs in 


an “unprotected” mode, which means that you do not need to enter the wireless password 


through the control panel to view or modify wireless settings. 


If a wireless password is set, the values for the following parameters will not appear through 
the control panel until the wireless password is entered: 


¢ MAC Address 


« ESSID 


¢ Leap Mode (if applicable) 
* Reset Network 


Format “WPa,b 


The following table identifies the parameters for this format. 


Parameters Details 
a = old wireless Accepted Values: 0000 through 9999 
password Default Value: 0000 


b = new wireless Accepted Values: 0000 through 9999 
password Default Value: 0000 
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AWR 
Set Transmit Rate 


Description Use this command to change the transmission parameters. 


Format *“WRa,b,c,d,e 


The following table identifies the parameters for this format. 


Parameters Details 

a = rate l Sets the 1 Mb/s transmit rate. 
Accepted Values: Y (On), N (Off) 

b = rate 2 Sets the 2 Mb/s transmit rate. 
Accepted Values: Y (On), N (Off) 

c = rate 5.5 Sets the 5.5 Mb/s transmit rate. 
Accepted Values: Y (On), N (Off) 

d = rate 11 Sets the 11 Mb/s transmit rate. 
Accepted Values: Y (On), N (Off) 

e = transmit power Accepted Values: 1, 5, 20, 30, 50, 100 
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~WR 
Reset Wireless Card 
Description Use this command to reinitialize the wireless card and the print server (wired or 
wireless) when the Wireless Print Server is running. The command also causes any wireless 
card in the printer to reassociate to the wireless network. Same function as the RESET 


HETWORK control panel parameter. 


Format ~WR 
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AWS 
Set Wireless Card Values 


Description Use this command to set the wireless card values for ESSID, Operating Mode, 
and Card Preamble. 


Format *WSe,o,p 


The following table identifies the parameters for this format. 


Parameters Details 


e = ESSID value Accepted Values: Any value up to 32 characters, including all 
ASCH and Extended ASCII characters, including the space 
character. When this parameter is left blank, the ESSID is not 
changed. 

Default Value: 125 


O = operating mode | Accepted Values: I (Infrastructure), A (Adhoc) 
Default Value: 1 


p = wireless card Accepted Values: L (Long), S (Short) 
preamble Default Value: L 
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This section provides you with a visual of the different Zebra Code pages. 
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Zebra Code Page 850 


This is the Zebra Code Page 850: 


Note « For hex 5C, a cent sign prints for all printer resident fonts. A backslash prints for 


downloaded fonts. 
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Zebra Code Page 1252 


This is the Zebra Code Page 1252: 


= il 
te) 
ates 
| S| ey isu | 
| AE S| ey isu | 
Ea Ea S| Fal Ea a 
= = 
i 8 | Ea 
a Ae : sa 
S| 8 | a a | 
a cu 


87 | 


5? | 


@ 
ral 
72 


| 42 | 
48, 


54 | 


Ea 
25 Ed 
| 28 4 | 


a 


6/9/06 


ZPL Il Programming Guide For x.10 through x.13 Firmware 


45541L-003 Rev. A 


343 


Zebra Code Pages 
Zebra Code Page 1252 


oo = a mo wo hm n al my 

_ + + + + + + nn Te] 

o a i a iw a wl a a 

=a La oa ir ae e po i to rae ira ae La i La a 

co 

ray “OQ Ne] <O = Dam j Pom 7 VA iy 

Olt Ln wo iw oo ® = a fy) + Lo ie o a 

LW} a i iv a Oo ra] i) iu) oO oO 0 oO ot 

Oo] a a a al i a a a iat a a is a a 

Fe + me oe 

= o o o 

oc 

An TH |p | | sa OH] ]-@O | [oO | [<@ v— |fr— 

©] o o ® a m + wo n on = m 

LW] © fas] =“ - a al al “4 ol Ol Ol 

oS] a al Od a is] al a iat) a is is 

rm a Ol ~m hm ee 

= U vu U Uv vu 

3 

= x 2 ]pD [pO PFD ye 

Qo 

o m nh ® 4 m ht 

tu Qo) cer) S co) S S 

QoQ a = Ol Ol oO is) 

Fe fs) 4 cu om + nn w ht co nD o oO UD o oe 

=| 2° (a) (a) (a) ia) fa) (a) o oO (a) ra) (a) oO o o 

c Ly! 

pe | pe | pe pe | pee | pe O | plu 

S/o th co a ® = a oO + itp) [te th o [op ind = 

Ld) ie tn i oO oo oO oo co oO co oo oO oO fo] a 

Qa ce ci fe | —_ toe | ca fe | — tae | fn | foe | fn | — fn | toe | fl 

Fe + ty a 

= Oo Oo oO 

oe + w + 

2] =“ Ww m a Te] wo hm oO foe) i) = a m + ln 

Lu} © wo wo wo wo wo wo wo wo o KR th hM i Nm ht 

jm | ca ci fn | om! fn | a: fn | - fn | fe | tt fel fe} fn | ca ci 

aS aa] a m he te 

= ul lu) o fu 0 

oc 

o 

o h 0 4 a] iy] uw ht 

_ vt + ite) in n in iT) 

| eT = — aT — — — 

Fe a i] oO h e 

= a on a for) o 

= : S 
-F > > q 

Pat wy MN 


45541L-003 Rev. A 


ZPL Il Programming Guide For x.10 through x.13 Firmware 


6/9/06 


344 | Zebra Code Pages 


Zebra Code Page 1252 


45541L-003 Rev. A ZPL II Programming Guide For x.10 through x.13 Firmware 6/9/06 


ASCII 


This section shows the American Standard Code for Information Interchange (ASCII) code 
used by Zebra printers. 
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ASCII Code Chart 


Shaded areas in Table 32 indicate characters not recommended for command prefix, format 
prefix, or delimiter characters. 


Table 32 « Zebra Used ASCII Code 


HEX | Character HEX | Character HEX | Character HEX | Character 
20 | Space 40 | @ 60 | «| 
21 ! 41 A 61 a 
22 - 42 B 62 b 
23 # 43 Cc 63 c 
24 $ 44 D 64 d 
25 % 45 E 65 e 
26 & 46 F 66 f 
“or | © 3&4 G 67 g 
23 | (CB H 68 h 
29 ) 49 I 69 i 
2A x 4A J 6A j 
2B + 4B K 6B k 
2C ; 4C L 6C 
2D - 4D M 6D m 
2E : 4E N 6E n 
2F / 4F O 6F te) 
30 0 50 P 70 p 
31 1 51 Q 71 q 
32 2 52 R 72 rt 
33 3 53 S 73 S 
34 4 54 T 74 t 
35 5 55 U 75 u 
36 6 56 Vv 76 Vv 
37 7 57 W 77 w 
38 8 58 x 78 Xx 
39 9 59 Y 79 y 
3A : 5A Z TA Zz 
3B : 5B [ 7B { 
3C < 5C \ 7C | 
1D GS 3D = 5D ] 7D } 
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Table 32 * Zebra Used ASCII Code (Continued) 


HEX | Character 


HEX | Character 


HEX | Character HEX | Character 
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Fonts and Bar Codes 


This section provides information about different fonts (type faces) and bar codes that can be 
used with the printer. 


Contents 
Standard Printer Fonts.............. 02.000 eee eee eens 350 
Proportional and Fixed Spacing...............200:0 cece eee eee teens 351 
Scalable Versus Bitmapped Fonts..................000 0c eee eee eee eee 352 
Scalable Fonts .............-.-200 220 eee eee eee 352 
Bitmapped Fonts ........... 0... cee ete eee 352 
Font Matrices :s.23.2 nang dgaeaih agin gk as ome oe Peed Dae eae ale oe RR ee 354 
6 dot/mm printhead ................ 000 eee 354 
8 dot/mm (203 dpi) printhead. ............... 00000 eee 354 
12 dot/mm (300 dpi) printhead................. 020000: e eee eee 355 
24 dot/mm (600 dpi) printhead. ............... 0.2002 355 
Bal God@S*.2.0% s:Agcae Antes Shag pee A idodandad Sava Taee Muay AGUA Hu AE A OAS 356 
Basic Format for Bar Codes. ............-200 0c cece eee eee eee 356 
Bar Code Field Instructions ................0 00000 eee eee 357 
Bar Code Command Groups ............--.0 0:00 c eee eee eee eee eee 358 
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Standard Printer Fonts 


Most Zebra printers come standard with 15 bitmapped fonts and one scalable font, see 
Figure 6. Additional downloadable bitmapped and scalable fonts are also available. Character 
size and density (how dark it appears) depend on the density of the printhead and the media 


used. 


Figure 6 * Examples of the Standard Printer Fonts 


FONT A cm ABCTuneye 12345, 


FONT B —— ascouxvz 12345 uppeR CASE ONLY 

FONT D —— ascowxyz 12345 

FONTE-- (OCR-B)ABCDwxyz 12345 
FONTF —— ABCDwxyz 12345 


rute-- ABYZ 12 

FONTH-- COCR-A>) UPPER CAXE ONLY 
FONTO —- (Scaleable) ABCD wxyz 12345 

FONT GS --®9°™@® 

FONT P ——  ascownz 12345 

FONT Q —— ABCDwxyz 12345 

FONT R —— ABCDwxyz 12345 

FONTS —— ABCDwxyz 12345 

FONTT -— ABCDwxyz 12345 

rontu -—- ABCDwxyz 12345 


FONT V — - ABCDwxyz 12345 


To use one of these fonts, you must either use the change alphanumeric default font command 
(“CF) or specify an alphanumeric field command (*A). 


The standard Zebra character set is Code 850 for character values greater than 20 HEX. There 
are six HEX character values below 20 HEX that are also recognized. Figure 7 shows how 
these character values are printed. 


Note « Unidentified characters should default to a space. 
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Figure 7 * Recognized HEX Values below 20 HEX 


HEX la will print 
HEX 1b will print 
HEX le will print 
HEX 1d will print 
HEX le will print 
HEX 1f will print 


Proportional and Fixed Spacing 
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Proportional and Fixed Spacing 


a O (numeric) 
a cA 
a re 
a lJ 
a iJ 
a \ 


Proportional spacing is different than fixed spacing. In Table 33, the intercharacter gap (space 
between characters) is constant for fonts A through H, which means that the spacing between 
all characters is the same. For example, the spacing between the letters MW is the same as 


between the letters IE. 


im 


The baseline is the imaginary line on which the bottom (base) of all characters (except any 
descenders) rest. The area between the baseline and the bottom of the matrix is used for any 
character “descenders.” Baseline numbers define where the baseline is located in relationship 
to the top of the matrix. For example, the baseline for font “E” is 23 dots down from the top of 


the matrix. 
Table 33 ¢ Intercharacter Gap and Baseline Parameters 
Font | Hx W (in dots) Type as eae wap ram 
A 9x5 U-L-D 1 7 
B 11x7 U 2 11 
C,D 18x 10 U-L-D 2 14 
E 28x 15 OCR-B 5 23 
F 26 x 13 U-L-D 3 21 
60 x 40 U-L-D 8 48 
H 21x 13 OCR-A 6 21 
GS 24 x 24 SYMBOL PROPORTIONAL 3 x HEIGHT/4 
0 DEFAULT: 15 x 12 PROPORTIONAL 3 x HEIGHT/4 
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Scalable Versus Bitmapped Fonts 


For scalable fonts, setting the height and width equally produces characters that appear the 
most balanced. Balanced characters are pleasing to the eye because actual height and width are 
approximately equal to each other. This is achieved through the use of a smooth-scaling 
algorithm in the printer. 


For bitmapped fonts, this balancing is built into the font. In actuality, the height of a bitmap 
font is slightly larger than the width. Bitmap fonts are always at the maximum size of the 
character’s cell. 


Scalable Fonts 


All dot parameters used in the commands to create scalable fonts are translated into a point 
size because scalable fonts are measured in point sizes, not dots. To determine how many dots 
to enter to obtain a particular point size, use the following formula. The actual point size will 
be an approximate value. 


(Point size) x (Dots per inch of Printer) 
72 


Dots = 


¢ For printers using a 6 dot/mm printhead the “dots per inch of printer” value is 152.4 

¢ For printers using a 8 dot/mm printhead the “dots per inch of printer” value is 203.2 

¢ For printers using a 12 dot/mm printhead the “dots per inch of printer” value is 304.8 

¢ For printers using a 24 dot/mm printhead the “dots per inch of printer” value is 609.6 
The actual height and width of the character in dots will vary, depending on the font style and 
the particular character. Therefore, some characters will be smaller and some will be larger 
than the actual dot size requested. The baselines for all scalable fonts are calculated against the 


dot size of the cell. The baseline is 3/4 down from the top of the cell. For example, if the size 
of the cell is 80 dots, the baseline will be 60 dots (3/4) down from the top of the cell. 


For more information concerning fonts and related commands, see ~DB on page 123 and ~DS 
on page 131. 


Bitmapped Fonts 


Internal bitmapped fonts can be magnified from 1 to 10 times their normal (default) size. The 
magnification factor is in whole numbers. Therefore, if the normal size of a bitmapped font is 
9 dots high and 5 dots wide, a magnification factor of 3 would produce a character of 27 dots 
high and 15 dots wide. Height and width can be magnified independently. 


Magnification Factor 


The font commands contain parameters for entering the height and width of printed characters. 
The values are always entered in dots. When entering these values for bitmapped fonts, use the 
following formula: 


Base Height x Magnification Factor = Height Parameter Value 
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The same principle applies when calculating width. 


Example: 
Base height = 9 dots 
Base width = 5 dots 


To magnify a bitmapped character with the above specifics 3 times its size: 
Height parameter = 27 [9 x 3] 
Width parameter = 15 [5 x 3] 


Changing Bitmapped Font Size 


Alphanumeric field command (*A) parameters h and w control the magnification and, 
therefore, the ultimate size of the font. The parameter is specified in dots, but ZPL II actually 
uses an integer multiplier times the original height/width of the font. For example, if you 


specify 
“AD,54 

you get characters three times their normal size (54 dots high), but if you specify 
“AD,52 


you receive the same result, not characters 52 dots high. 


Defining only the height or width of a bitmapped font forces the magnification to be 
proportional to the parameter defined. If neither is defined, the “CF height and width are used. 
For example, if the height is twice the standard height, the width will be twice the standard 
width. 


=P Example « If a “CF command, with height and width parameters defined, is used to set the 


6/9/06 


first font, any “A commands (to select a different font) that follow must have the height and 
width parameter filled in. 


If this is not done, the newly selected font will be magnified using values for the “CF height 
and width parameters. This is an example of what happens:. 


ZPL Il CODE GENERATED LABEL 
a 

*XA*LL1800 ZEBRA.... 
“F050, 50*CFD, 26, 10*°FDZEBRA....*FS 
“FO50,100*FD"Bar Code, Bar None"*FS eee 7 " 
“F050, 200*°AA* FDZEBRA....*FS Bar Code» Ger None 
“FO50,250*°FD"Bar Code, Bar None"*FS 
“XZ 


cEBRA.... 


"Bar Code; Bar None" 
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Font Matrices 


Type Key U = Uppercase, L = Lowercase, D = Descenders 


6 dot/mm printhead 


Matrix Character Size 
Font Type 
HxW (in dots) HxW (in in.) Char./in. | HxW (in mm) | Char. /mm 
A 9x5 U-L-D 0.059 x 0.039 25.4 1.50 x 0.99 1.01 
B 11x7 U 0.072 x 0.059 16.9 1.82 x 1.50 0.066 
C,D 18x 10 U-L-D 0.118 x 0.079 12.7 2.99 x 2.00 0.05 
E 21x10 OCR-B 0.138 x 0.085 11.7 3.50 x 2.16 0.46 
F 26 x 13 U-L-D 0.170 x 0.105 9.53 4.32 x 2.67 0.37 
G 60 x 40 U-L-D 0.394 x 0.315 3.18 10.0 x 8.00 0.125 
H 17x 11 OCR-A 0.111 x 0.098 10.2 2.81 x 2.48 0.40 
GS 24 x 24 SYMBOL 0.157 x 0.157 6.35 3.98 x 3.98 0.251 
0 Default: 15 x 12 
8 dot/mm (203 dpi) printhead 
Matrix Character Size 
Font Type 
HxW (in dots) HxW (in in.) Char./in. | HxW (in mm) | Char. /mm 
A 9X5 U-L-D 0.044 x 0.030 33.3 1.12 x 0.76 1.31 
B 11X7 U 0.054 x 0.044 22.7 1.37x 1.12 0.89 
C,D 18 X 10 U-L-D 0.089 x 0.059 16.9 2.26 x 1.12 0.66 
E 28x 15 OCR-B 0.138 x 0.098 10.2 3.50 x 2.49 0.40 
F 26 x 13 U-L-D 0.128 x 0.079 12.7 3.25 x 2.00 0.50 
G 60 x 40 U-L-D 0.295 x 0.197 4.2 7A9 x 5.00 0.167 
H 21x 13 OCR-A 0.103 x 0.093 10.8 2.61 x 2.36 0.423 
GS 24 x 24 SYMBOL 0.118 x 0.118 8.5 2.99 x 2.99 0.334 
P 20 x 18 U-L-D 0.098 x 0.089 N/A 2.50 x 2.25 N/A 
Q 28 x 24 U-L-D 0.138 x 0.118 N/A 3.50 x 3.00 N/A 
R 35x31 U-L-D 0.172 x 0.153 N/A 4.38 x 3.88 N/A 
S 40 x 35 U-L-D 0.197 x 0.172 N/A 5.00 x 4.38 N/A 
T 48 x 42 U-L-D 0.236 x 0.207 N/A 6.00 x 5.25 N/A 
U 59 x 53 U-L-D 0.290 x 0.261 N/A 7.38 x 6.63 N/A 
Vv 80x 71 U-L-D 0.394 x 0.349 N/A 10.00 x 8.88 N/A 
0 Default: 15 x 12 U-L-D Scalable Scalable 
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Font Matrices 


Matrix Character Size 
Font Type 
HxW (in dots) HxW (in in.) Char./in. | HxW(inmm) | Char. /mm 
A 9X5 U-L-D 0.030 x 0.020 50.8 0.75 x 0.50 2.02 
B 11X7 U 0.036 x 0.030 33.8 0.91 x 0.75 1.32 
C,D 18 X 10 U-L-D 0.059 x 0.040 25.4 1.50 x 1.00 1.00 
E 42 x 20 OCR-B 0.138 x 0.085 23.4 1.75 x 1.08 0.92 
F 26 x 13 U-L-D 0.085 x 0.053 19.06 2.16 x 1.34 0.74 
G 60 x 40 U-L-D 0.197 x 0.158 6.36 5.00 x 4.00 0.25 
H 34 x 22 OCR-A 0.111 x 0.098 10.20 2.81 x 2.48 0.40 
GS 24 x 24 SYMBOL 0.079 x 0.079 12.70 1.99 x 1.99 0.52 
P 20 x 18 U-L-D 0.067 x 0.060 N/A 1.69 x 1.52 N/A 
Q 28 x 24 U-L-D 0.093 x 0.080 N/A 2.37 x 2.03 N/A 
R 35x 31 U-L-D 0.117 x 0.103 N/A 2.96 x 2.62 N/A 
S) 40 x 35 U-L-D 0.133 x 0.177 N/A 3.39 x 2.96 N/A 
T 48 x 42 U-L-D 0.160 x 0.140 N/A 4.06 x 3.56 N/A 
U 59 x 53 U-L-D 0.197 x 0.177 N/A 5.00 x 4.49 N/A 
Vv 80x 71 U-L-D 0.267 x 0.237 N/A 6.77 x 6.01 N/A 
0 Default: 15 x 12 U-L-D Scalable Scalable 
24 dot/mm (600 dpi) printhead 
Matrix Character Size 
Font Type 
HxW (in dots) HxW (in in.) Char./in. | HxW (in mm) | Char. /mm 
A 9X5 U-L-D 0.015 x 0.010 100.00 0.38 x 0.25 4.00 
B 11X7 U 0.018 x 0.015 66.66 0.46 x 0.38 2.60 
C,D 18 X 10 U-L-D 0.030 x 0.020 50.00 0.77 x 0.51 2.0 
E 42 x 20 OCR-B 0.137 x 0.087 11.54 3.47 x 2.20 0.45 
F 26 x 13 U-L-D 0.043 x 0.027 37.5 1.10 x 0.68 1.50 
G 60 x 40 U-L-D 0.100 x 0.080 12.50 2.54 x 2.04 0.50 
H 34 x 22 OCR-A 0.100 x 0.093 10.71 2.54 x 2.37 0.42 
GS 24 x 24 SYMBOL 0.040 x 0.040 25.00 1.02 x 1.02 1.00 
P 20 x 18 U-L-D 0.067 x 0.060 N/A 1.69 x 1.52 N/A 
Q 28 x 24 U-L-D 0.093 x 0.080 N/A 2.37 x 2.03 N/A 
R 35x31 U-L-D 0.117 x 0.103 N/A 2.96 x 2.62 N/A 
S) 40 x 35 U-L-D 0.133 x 0.117 N/A 3.39 x 2.96 N/A 
T 48 x 42 U-L-D 0.160 x 0.140 N/A 4.06 x 3.56 N/A 
U 59 x 53 U-L-D 0.197 x 0.177 N/A 5.00 x 4.49 N/A 
Vv 80x 71 U-L-D 0.267 x 0.237 N/A 6.77 x 6.01 N/A 
0 Default: 15 x 12 U-L-D Scalable Scalable 
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Bar Codes 


Every bar code contains data made up of a sequence of light spaces and dark bars that 
represent letters, numbers, or other graphic characters. The usable characters differ among the 
various kinds of bar codes. Each bar code section in the Command Reference provides a table 
of applicable characters. Start and stop characters and check digits are used by many, but not 
all, bar codes. These will be indicated in the specific bar code explanations. 


Zebra printers can print the following kinds of bar codes: 


Bar code modulus “X” dimensions Linear bar codes 
¢ Picket fence (non-rotated) orientation: * Code 11 

¢ 203 dpi = 0.0049 in. mil to 0.049 in. * Code 39 

* 300 dpi = 0.0033 in. mil to 0.033 in. * Code 93 


¢ Ladder (rotated) orientation: * Code 128 with subsets A/B C and 
* 203 dpi = 0.0049 in. mil to 0.049 in. UCC Case Codes 
* 300 dpi = 0.0039 in. mil to 0.039 in. * ISBT-128 
Two-dimensional bar codes © PCA 
* Code 49 + UPC-E 
* Maxi Code * EAN-8 
* PDF-417 * EAN-13 
* QR Code ¢« UPC and EAN 2 or 5 digit extensions 
* Codablock * Plessey 


¢ Postnet 

¢ Standard 2 of 5 

¢ Industrial 2 of 5 

¢ Interleaved 2 of 5 


¢ DataMatrix 
¢ Micro-PDF417 


Bar code ratios 


e 2:1 
a * LOGMARS 
* MSI 
© 5:2 Codab 
: 3:1 Oodabdar 
¢ RSS-14 


Basic Format for Bar Codes 
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The basic format for bar codes is quiet zone, start character, data, check digit, stop character, 
and quiet zone. Not all bar codes require each of these elements. 


Every bar code requires a quiet zone. A quiet zone (sometimes called a “clear area”) is an area 
adjacent to the machine-readable symbols that ensure proper reading (decoding) of the 
symbols. No printing is permissible within this area. Preprinted characters, borders, and 
background color are acceptable if they are invisible to the reading device; these are used in 
some applications but restrict the type of reading device that can be used. The size of the quiet 
zone depends on the size of bar widths (usually 10 times the width of the narrow bar). 
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Figure 8 « Quiet Zone in a Bar Code 


Quiet Zone Quiet Zone 


a EB 
1 LI 2 


Bar Code Field Instructions 
To create a bar code, a bar code field command must be contained in the label format. Table 34 


shows the bar code field commands. The number in brackets denotes the print ratio. Each 
command produces a unique bar code. 


Important ¢ (*) for Fixed Printing Ratio means that the ratio between the width of the bars in 
the code is a fixed standard and cannot be changed. 


Table 34 « Bar Code Field Commands 


“Bl Code 11 (USD-8) 2.0 - 3.0] 
“B2 Interleaved 2 of 5 230. =" 340) 
“B3 Code 39 (USD-3 & 3 of 9) 2.0 - 3.0] 
“B4 Code 49 (*) Fixed] 
“B7 PDF417 (*) Fixed] 
“B8 EAN-8 (*) Fixed] 
“BO UPC-E Fixed 
“BA Code 93 (USS-93) (*) Fixed] 
“BB CODABLOCK A, E, F (*) Fixed] 
“BC Code 128 (USD-6) (*) Fixed] 
“BD UPS MaxiCode (*) Fixed] 
“BE EAN-13 Fixed] 
“BF Micro-PDF417 Fixed] 
“BI Industrial 2 of 5 230 -= 34:04] 
“BJ Standard 2 of 5 200, = 3.0] 
“BK ANSI Codabar (USD-4 & 2 of 7) 2.0 - 3.0] 
“BL LOGMARS 20) 33.07) 
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Table 34 « Bar Code Field Commands (Continued) 


“BM MSI A.e0:) =~ 3.0) 
“BP Plessey 20 = Bin Oy) 
“BOQ QR Code (*) Fixed] 
“BS UPC/EAN Extensions (*) Fixed] 
“BU UPC-A (*) Fixed] 
“BX Data Matrix (*) Fixed] 
“BZ PostNet (*) Fixed] 


Additionally, each bar code field command can be issued with a definition parameter string. 
The parameter string defines field rotation, height, and interpretation line status for all bar 
codes. For some bar codes, the parameter string also sets a check digit, start character, and/or 
stop character. Use the definition parameter string to command the printer to print bar codes of 
appropriate heights and densities that conform to the specifications of the application. 


The use of the parameter string is optional because all parameters have default values. If the 
default values for all of the bar code parameters suit the application, then only the bar code 
command needs to be entered. 


Parameters in bar code field commands are “position specific.” If a value (other than the 
default value) is manually entered for one parameter, a comma , the ZPL II delimiter 
character, must be used to mark the position of the preceding parameters in the string. 


To change just the third parameter, enter two commas and then the value for the third 
parameter. The default values will be automatically used for the first and second parameters. 


In the ZPL IT Programming Guide Volume Two, see the Saving Label Formats as Graphic 
Images topic in the Programming Exercises chapter, the *B3 bar code field command has five 
parameters. The third parameter defines the height of the bar in dots. The bar code is to be 
printed using default values for the first two parameters EXCEPT the height of the bar. This is 
to be 20 dots. Finally, the “N” indicates that a print interpretation line will not print with the 
bar code. The command would be entered as follows: 


“B3yp 7 Z07N 


Delimiters (commas) are not required for parameters between a manually entered value and 
the end of the parameter string. 
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Bar Code Command Groups 


Bar code commands are organized into four groups. Each group represents a type of bar code. 
Table 35 through Table 38 identify the groups and the bar codes they contain: 


Table 35 * Numeric Only Bar Codes 


“B1 Code 11 

“B2 Interleaved 2 of 5 
ABI Industrial 2 of 5 

“BIJ Standard 2 of 5 

“BK ANSI Codabar (or NW-7) 
“BM MSI 

“BP Plessey 

“BZ POSTNET 


Table 36 « Retail Labeling Bar Codes 


“B8 EAN-8 
“BO UPC-E 
ABE EAM-13 
“BS UPC/EAN extensions 
“BU UPC-A 


Table 37 « Alphanumeric Bar Code 


“B3 Code 39 

“BA Code 93 

“BC Code 128 

“BL LOGMARS 
Table 38 * Two-Dimensional Bar Codes 

“BA Code 49 

“B7 PDF417 

“BB CODABLOCK 

“BD UPS MaxiCode 

“BF MicroPDF417 

“BO QR Code 

“BX Data Matrix 
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Mod 10 and Mod 43 
Check Digits 


This section provides information about Mod 10 and Mod 43 check digits. 


Contents 
Mod 10 Check Digit... 00.00.0000. ccc ccc cece tee e eee eeeee 362 
Mod 43 Check Digit... 00.0... 00 0. cece ce cece eee teen een ee ees 363 
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Mod 10 Check Digit 


The calculations for determining the Mod 10 Check Digit character are as follows: 


1. Start at the first position and add the value of every other position together. 
0+2+4+6+8+0=20 


2. The result of Step | is multiplied by 3. 
20 x 3 = 60 


3. Start at the second position and add the value of every other position together. 
14+34+5+74+9=25 


4. The results of steps 1 and 3 are added together. 
60 + 25 = 85 


5. The check character (12th character) is the smallest number which, when added to the 
result in step 4, produces a multiple of 10. 


85 + X = 90 (next higher multiple of 10) 
X =5 Check Character 


This bar code illustrates the above example. The digit on the right (5) is the check digit. 


123456 7eoe TENS 
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The calculations for determining the Mod 43 check Digit character are as follows: 


Each character in the Code 39 character set has a specific value, as follows: 


OAANINDMAHBWNK SO 


in 
S 


B=11 
C=12 
D=13 


Example « Data string 2345ABCDE/ 


M=22 
N=23 
O=24 
P=25 
Q=26 
R=27 
S=28 
T=29 
U=30 
V=31 
W=32 


1. Add the sum of all the character values in the data string. Using the chart above, the sum 
of the character values is as follows: 


14+24+3+4+5+4+10+114+12+13+14+40=115 


2. Divide the total by 43. Keep track of the remainder. 


3. The “check digit” is the character that corresponds to the value of the remainder. 


Below is a bar code that illustrates the example. The character on the right, T, is the check 


#1 2345ABCDE“T# 


AFO125, 1@@4B3N,Y,19@, 7. NAFD12345ABCDE/AFS 


=p 
115/43 = 2 Remainder is 29 
Remainder = 29 
29 is the value for the letter T. 
T is the check digit. 
digit. 
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Notes « 
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ZB64 Encoding and 
Compression 


This section describes the Base 64 MIME (ZB64) encoding and compression. This is the same 
type of MIME encoding that is used in e-mail. 


Contents 
Introduction to B64 and 264... 2... eee eee 366 
B64 and: 764 Encoding. 2c< cc aghekcgaads ck ge aaa ts deeate ad ene eteegmea da 368 
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The first encoding, known as B64, encodes the data using the MIME Base64 scheme. Base64 
is used to encode e-mail attachments and is specifically designed to address communications 
path limitations, such as control characters and 7-bit data links. It encodes the data using only 
the printable ASCII characters: 


ABCDEFGHIJKLMNOPQRSTUVWXYZ 
abcdefghljklmnopgqrstuvwxyz 


0123456789 +/= 


With the use of ZPL, this has the added benefit of avoiding the caret (*) and tilde (~) 
characters. Base64 encodes six bits to the byte, for an expansion of 33 percent over the un- 
enclosed data. This is much better than the 100 percent expansion given by the existing ASCII 
hexadecimal encoding. 


The second encoding, known as Z64, first compresses the data using the LZ77 algorithm to 
reduce its size. (This algorithm is used by the PKWARE® compression program PKZIP™ and 
is integral to the PNG graphics format.) The compressed data is then encoded using the MIME 
Base64 scheme as described above. 


A CRC is calculated across the Base64-encoded data. If the CRC-check fails or the download 
is aborted, the object can be invalidated by the printer. 


The robust encodings can be piggybacked on the existing download commands with full 
backward compatibility. This is done by prefacing the new encodings with a header that 
uniquely identifies them. The download routines in the printer firmware can key-off the header 
to determine whether the data is in the old ASCII hexadecimal encoding or one of the new 
encodings. This allows existing downloadable objects to be used in their present format, while 
new objects can be created using the same download commands with the new encodings for 
increased integrity and reduced download times. 


For easy reference, B64 and Z64 are referred to as ZB64. In any reference to the ZB64 
encoding, assume that both Base64-only (B64) and LZ77/Base64 (Z64) encodings are 
accepted. 


Example ¢ The following is an example of an existing download command using the new 
encoding: 


~DTARIAL, 59494, :Z264:H4sTCMB8+DMAC0FSSUFML1RURgDsmnd8VEW7x5+ZO 
eds yi bZNNJh1yWhbEJIwY SwJDGNkmwghJIgJYEEEhQI PSggKAjEAilTiVaSolJd 
YNBAkIGgGxUBVUUCGU0OJUQSCOWFnPVbE+SF18+9H+8£973X+3J3m93umzzNznvn 
NSSFGRJ6ARAVZVXK7 XDaxXLyTiR5BJ7ontuZPQ8241I5RKIabewtaba8+pUlrvDZ 
iciv 


[multiple lines deleted] 


/O6DU5wZ7ie2+g4xzDPwCpwm3nqw2GAPcdc1lxF4fIP66jHjJncmKvKzh/ZUNCx 
19/QQx2HXHYB4m/PkQcdCdx2G70Yt+mszkMh4iZxoifvkh8 9BFipo87kwD/Bf 
/dOcycAAEA:alb2 
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The parameters are identical to the existing ~DT command: 


Table 39 * ~DT Command Parameters 


Parameter Details 


o = font name Accepted Values: any valid TrueType name, up to 8 characters 
Default Value: if a name is not specified, UNKNOWN is used 
In this example, Arial is the specified font. 


s = font size Accepted Values: the number of memory bytes required to hold 
the Zebra-downloadable format of the font 


Default Value: if an incorrect value or no value is entered, the 
command is ignored 


In this example, 59494 is the size. 


To maintain compatibility with the existing ASCII hexadecimal 
encoding, this field must contain the size of the un-enclosed and 
uncompressed object — the number of bytes that are finally 
placed into the printer’s memory, not the number of bytes 
downloaded. 


data = data string Accepted Values: a string of ASCII hexadecimal values (two 
hexadecimal digits/byte). The total number of two-digit values 
must match parameter s. 


Default Value: if no data is entered, the command is ignored 


Everything following the size field is data. The new encoding 
imposes a header with a unique signature. The new encoding must 
start with the characters :B64: (data encoded in Base-64 only) or 
:Z64: (data compressed with LZ77, then encoded in Base-64) 
followed by the encoded data. 


After the data is presented, another colon (:) and four hexadecimal 
digits comprise the CRC. The Base64 standard allows new-line 
characters (carriage returns and line feeds) to be inserted into the 
encoded data for clarity. These characters are ignored by the 
printer. 


When downloading graphics, the colon is used in the current ASCII hexadecimal encoding 
indicate “repeat the previous dot row.” Since this shorthand is invalid for the first character of 
data (no previous dot row has been downloaded), it is safe for the printer to detect the leading 
colon character as the lead-in for the new encodings. 
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These download encodings, B64 and Z64, are created as drop-in replacements for the existing 
ASCII hexadecimal encoding. 


B64 encoding do the following: 
¢ Encode the compressed data using the MIME Base64 algorithm. 
* Calculate a CRC across the encoded data. 


¢ Add a unique header to differentiate the new format from the existing ASCII hex 
encoding. 


Z64 encoding do the following: 
¢ Compress the data using the LZ77 algorithm. 
¢ Encode the compressed data using the MIME Base64 algorithm. 
* Calculate a CRC across the encoded data. 


¢ Adda unique header to differentiate the new format from the existing ASCII hexadecimal 
encoding. 


The data field have this format: 


:id:encoded_data:crce 


This table identifies the parameters for this format: 


Table 40 « Format Parameters 


Parameter Details 


:id the identifying string B64 or Z64 


:iencoded_ data data to download, compressed with LZ77 (if the id parameter is 
set to Z64) and encoded with Base64. 


:cre four hexadecimal digits representing the CRC calculated over the 
:encoded_data field. 


The printer calculates a CRC across the received data bytes and compare this to the CRC in the 
header. A CRC mismatch is treated as an aborted download. 


The B64 and Z64 encodings can be used in place of the ASCII hexadecimal encoding in any 
download command. The commands are: 

~DB — Download Bitmap Font 

~DE — Download Encoding 

~DG — Download Graphic 

~DL — Download Unicode Bitmap Font 

~DS — Download Scalable Font 

~DT — Download TrueType Font 

~DU — Download Unbounded TrueType Font 

“GF — Graphic Field (with compression type set to “ASCII hex”) 
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The ~DB (Download Bitmap Font) command can use the new encodings in place of the ASCII 
hexadecimal encoding in data sub-fields. Each character is encoded individually. However, for 
small amounts of data, the identifying B64 or Z64 header and trailing CRC may negate any 
gains made by using the new format. 


For backward compatibility, the *HG (Host Graphic) command uses the ASCII hexadecimal 
encoding. It does not use the new encodings. 
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Field Interactions 


This section provides you with examples that show how commands interact with various 
justification parameters. The examples are in charts for these orientations: 


¢ Normal 
¢ Rotated 
¢ Bottom-up 


¢ Inverted 


These charts are designed so that you can identify the location of the field origin and 
interactions between the rotation, formatting and justification commands. 
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Normal Orientation 


Table 41 shows you the various normal orientation outputs: 


Table 41 * Normal Orientation Examples 


AFPH AFPV AFPR 


EDCBA 


“ABCDE 


AFO 
Left 
Justified 


_. | —ABCDE EDCBA 


Justified 


EDCBA 


ABCDET 


AFO 
Right 
Justified 


ABCDE_ 
AFT 

Right 
Justified 


EDCBA 


SG? mS moocts moows 
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Rotated Orientation 


Table 42 shows you the various rotated orientation outputs: 


Table 42 * Rotated Orientation Examples 


AFPH AFPV AFPR 


‘FO tnoow> 
Left 


Justified 


AFT 
Left 
Justified 


moo os 


AFO mO ooo ost 
Right 


Justified 


¥9903 | wa9qa 9903 


AFT 
Right 
Justified 


mS co Ol 


yvaoua 


“yagav Jd98y jaa" 3099¢ 
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Bottom Up Orientation 


Table 43 shows you the various bottom up orientation outputs: 


Table 43 * Bottom Orientation Examples 
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AFPH AFPV AFPR 
ae e Me moow aes 
— © oc 
Justified Pas rz) 
= 2 
Lid 
AFT = moo w 
Left 7 a 
Justified oo S 
=. Lid 
1 
“FO wT xemon ut ga 
Right ra) 
Justified = i 
a 
AFT “o- at moo Ww a 
Right A rc) 
Justified 
ce 
ma a 
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Inverted Orientation 


Table 44 shows you the various inverted orientation outputs: 


AFO 
Left 
Justified 


AFT 
Left 
Justified 


Table 44 « Inverted Orientation Examples 


AFPH 


“Faoav 


ja9a¥r 


AFPV 
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AFPR 


Tyaoas 


vaoaa 


AFO 
Right 
Justified 


j000v 


vaoaa 


AFT 
Right 
Justified 
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Symbols 

SMW, 232 

“NB, network boot, 322 

“NN, set SNMP parameters, 323 

“NP, set primary/secondary device, 324 
“NS, change wired network settings, 325 
“NT, set SMTP, 326 

“NW, set web authentication timeout value, 327 
“WA, set antenna parameters, 328 

“WE, set wireless encryption values, 329 
“WI, change wireless network settings, 331 
“WL, set LEAP parameters, 332 

“WP, set wireless password, 334 

“WR, set transmit rate, 335 

~WL, print network configuration label, 333 
~WR, reset wireless card, 336 

~WS, set wireless card values, 337 


A 


abort download graphic, 130 
advanced counter 

reset, 249 
advanced counter reset, 302 
AFI byte 

read command (“RA), 290 

write command (“WF), 316 
alphanumeric default font 

change, 109 
antenna parameter setting via ZPL, 328 
applicator reprint, 246 
authentication timeout for printer home page, 327 
authentication type 

setting via ZPL command, 329 
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auxiliary port 
set, 195 


B 


backfeed sequence 
change, 203, 204 
bar code field default, 103 
battery 
set condition, 193 
battery status, 164 
bitmap font 
download, 123 
bitmapped fonts, 350 
box, 155 


Cc 


cache on, 116 
calibration 

RFID tag using ZPL (“HR), 287 
cancel all, 187 
cancel format, 201 
caret 

change, 107 
change alphanumeric default font, 109 
change backfeed sequence, 203, 204 
change caret, 107 
change delimiter, 108 
change international font, 111 
change memory letter designation, 115 
change network settings, 236 
change tilde, 118 
change wired network settings, 325 
circle, 157 
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CODABLOCK, 43 
considerations for “FD character set, 45 
considerations for the “BY, 45 

code 11, 18 

code 128 
subsets, 49 
subsets A and C, 52 
subsets a, b, and c, 47 

code 39, 22 

code 49, 26 
automatic mode, 29 
field data character set, 29 

code 93, 39 
full ASCII mode, 40 

code validation, 119 

comment, 154 

communications diagnostics, 191 
enable, 191 

concantination, 150 

configuation 
update, 207 

configuration 
using ZPL commands, 339, 371 

configuration label 
print, 275 

contacts, xix 

counter reset (~RO), 302 

current partially input format 
cancel, 209 

currently connected printer 
set transparent, 237 

customer service, xix 


D 


darkness 
set, 251 
data matrix, 99 
date for real time clock 
set, 268 
define EPC data structure (RB), 292 
define language, 213 
define password, 215 
define printer name, 214 
delete object, 180 
delimiter 
change, 108 
description information 
display, 178 
detect multiple RFID tags (*RN), 301 
diagnostics 
disable, 192 
diagonal line, 158 
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directory label 

print, 276 
disable diagnostics, 192 
discharge mode 

battery, 211 
display description information, 178 
double signal mode 

setting, 308 
download bitmap font, 123 
download encoding, 125 
download format, 126 
download graphic 

abort, 130 
download graphics, 127, 134 
download Intellifont, 131 
download true type font, 132 
download unbounded true type font, 133 


E 


E.A.S. bit enable/disable command (RE), 295 
EAN-13, 63 
EAN-8, 35 
Electronic Product Code (EPC) 
define EPC data structure (“RB), 292 
ellipse, 159 
enable RFID motion (“RM), 300 
encoding 
download, 125 
select, 252 
encryption 
set LEAP parameters, 332 
set values via ZPL, 329 
end format, 282 
erase download graphics, 136 
error handling, 307 
ESSID 
setting via ZPL, 337 


F 


feedback 
suppress, 279 
field 
field reverse, 148 
orientation, 153 
parameter, 147 
separator, 149 
typeset, 150 
variable, 152 
field block, 136, 137 
field clock 
real time clock, 139 
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field data, 140 


field hexadecimal indicator, 141 


field number, 145 
field orientation, 153 
field origin, 146 
field parameter, 147 
field reverse print, 148 
field separator, 149 
field typeset, 150 
field variable, 152 
flash memory 

initialize, 188 
font identifier, 121 
font name 

to call font, 14 
fonts 

font matrices, 354 

standard printer fonts, 350 
format 

cancel, 201 

download, 126 

end, 282 

pause, 201 

recall, 280 

set, 278 


G 


Gen 2 

specify using ZPL, 305 
graphic 

box, 155 

circle, 157 

diagonal line, 158 

ellipse, 159 

field, 160 

recall, 281 

symbol, 162 
graphic field, 160 
graphics 

download, 127, 134 

erase download, 136 

upload, 177 


graphing sensor calibration, 194 


H 


head test 
fatal, 199 
interval, 206 
non-fatal, 200 
head test fatal, 199 
head test interval, 206 
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head test non-fatal, 200 
host 
directory list, 175 
graphic, 167 
identification, 169 
RAM status, 170 
status return, 171 
host directory list, 175 
host graphic, 167 
host identification, 169 
host RAM status, 170 
host status return, 171 


host verification command (“HV), 174 


l 
image 

load, 182 

move, 184 

save, 185 
image load, 182 
image move, 184 
image save, 185 
industrial 2 of 5, 68 
initialize Flash memory, 188 
interleaved 

2 of 5, 20 
international font 

change, 111 


K 
kill battery, 211 


L 


label 
maximum length, 224 
reverse print, 218 
shift, 219 
top, 220 
label home, 216 
label length, 217 
set, 197 
language 
define, 213 
LEAP mode 
setting using ZPL, 332 
liability, ii 
LOGMARS, 74 


map clear, 221 
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Index 


maximum label length, 224 
media 
darkness, 222 
feed, 223 
ordering, xix 
tracking, 227 
type, 229 
media darkness, 222 
media sensor 
set, 266 
media sensor calibration, 190 
set, 190 
media tracking, 227 
media type, 229 
memory letter designation 
change, 115 
mitror image 
printing, 240 
mode protection, 228 
modify head warning, 232 
motion in RFID label, 300 
MSI, 76 
multiple field origin locations, 142 


N 


network 

change settings, 236 

connect, 233 

ID number, 234 
network boot command, 322 
network configuration label 

print via ZPL, 333 
network connect, 233 
network ID number, 234 
network printers 

set all transparent, 235 
network settings 

setting via ZPL, 331 
number of retries for block (RR), 304 


O 


object delete, 180 
offset for real time clock 
set, 260 
optional memory 
reset, 189 
ordering ribbon and media, xix 


Pp 


password 
define, 215 
set wireless password, 334 
password for RFID tag, 315 
pause 
programmable, 242 
pause format, 201 
PDF417, 31 
consideration for “FD, 34 
POSTNET, 105 
power on 
reset, 202 
primary/secondary device 
setting via ZPL, 324 
print 
start, 247 
width, 248 
print mode, 225 
print network configuration label 
via ZPL command, 333 
print orientation, 241 
print quantity, 243 
print rate, 244 
print start, 247 
print width, 248 
printer 
sleep, 283 
printer name 
define, 214 
printer sleep, 283 
printer web pages 
set timeout value, 327 
printhead resistance 
set, 265 
printing mirror image of label, 240 
programmable pause, 242 
programming position 
set using ZPL, 307 


Q 


QR code 

normal mode, 85 
quantity 

print, 243 


R 


read power 
change using ZPL, 314 
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read RFID tag 


read or write RFID format (“RF), 296 


read RFID tag (ART), 311 
read/write position 
set using ZPL, 307 
real time clock 
set language, 256 
set mode, 256 
real time clock date format 
select, 212 
real time clock time format 
select, 212 
recall format, 280 
recall graphic, 281 
reprint 
after error, 210 
applicator, 246 
reset 
power on, 202 
reset advanced counter, 249 


reset advanced counters (~RO), 302 


reset optional memory, 189 
reset wireless card, 336 


return data to host computer (SHV), 174 


RFID 


calibrate RFID tag using ZPL (“HR), 287 
change read power using ZPL, 314 
change write power using ZPL, 314 
detect multiple tags (RN), 301 
enable motion (“*RM), 300 
number of retries for block (*RR), 304 
RFID setup command (“RS), 305 
verify write operation (“WV), 320 

RFID tag ID command (“RI), 298 


ribbon 
ordering, xix 

ribbon tension 
set, 208 


Ss 


sales, x1x 
scalable font, 12, 350 
download Intellifont, 131 
select encoding, 252 
sensor calibration 
graphing, 194 
serial communications 
set, 250 
serialization data, 258 
serialization field 
standard “FD string, 253 


set all network printers transparent, 235 
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set auxiliary port, 195 
set battery condition, 193 
set darkness, 251 
set dots 
millimeter, 198 
set dots per millimeter, 198 
set label length, 197 
set RFID tag password (“RZ), 315 
set serial communications, 250 
set units of measurements, 230 
set up RFID information (“RS), 305 
SGTIN-64 standard programming example, 294 
single signal mode 
setting, 308 
slew 
home position, 239 
slew given number 
dot rows, 238 
slew to home position, 239 
SMTP parameters 
setting via ZPL, 326 
SNMP parameters 
setting via ZPL, 323 
specify number of retries for block (*RR), 304 
standard printer fonts, 350 
start print, 261 
symbol, 162, 166 


T 


tag type 

specify using ZPL, 305 
tear-off adjust position, 272 
technical support, xix 
tilde 

change, 118 
time for real time clock 

set, 268 
timeout value for printer home page, 327 
transfer object, 273 
transmit rate setting via ZPL, 335 
transponders 

calibration using ZPL (“HR), 287 
true type font 

download, 132 


U 


unbounded true type font 
download, 133 

units of measurement 
set, 230 

UPC/EAN extensions, 92 
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UPC-A, 97 Z 


UPC-E, 37 Zebra Programming Language (ZPL II) 


update configuration, 207 

upload graphics, 177 

UPS maxicode, 60 
considerations for “FD, 61 

use font name to call font, 14 


V 


verify RFID write operation (‘WV), 320 
void handling, 307 


W 


web authentication timeout value, 327 
width 

print, 248 
wired print server 

“NB to set check for, 322 


“HAR, Calibrate RFID Transponder, 287 
“RA, Read AFI Byte, 290 

ARB, Define EPC Data Structure, 292 

ARE, Enable/Disable E.A.S. Bit, 295 

ARF, Read or Write RFID Format, 296 

ARI, Get RFID Tag ID, 298 

ARM, Enable RFID Motion, 300 

ARN, Detect Multiple RFID Tags, 301 
ARR, Specify RFID Retries for a Block, 304 
ARS, RFID Setup, 305 

ART, Read RFID Tag, 311 

ARW, Set RFID Read and Write Power, 314 
“RZ, Set RFID Tag Password, 315 

AWF, Write AFI Byte, 316 

AWT, Write Tag, 318 

AWV, Verify RFID Write Operation, 320 
~RO, Reset Advanced Counters, 302 


change network settings, 325 ZebraNet Alert 
wireless card halt, 263 
reset via ZPL, 336 set, 269 
setting values via ZPL, 337 ZPL 
wireless password set, 271 


setting via ZPL, 334 
Wireless Print Server 
ZPL commands, 339, 371 
wireless print server 
change network settings, 331 
write AFI byte command (“WF), 316 
write power 
change using ZPL, 314 
write RFID format (*RF), 296 
write RFID tag (“WT), 318 
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ZPL commands 


“B7, 31 
Wireless Print Server commands, 339, 371 
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